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INTRODUCTION 



PRODUCT INTRODUCTION 

The VT125 is a graphics display terminal that combines a bit map 
architecture with the alphanumeric capability of the VT100 video 
terminal. The VT125 is a smart terminal that directly executes 
Digital's general purpose graphics descriptor, ReGIS (Remote 
Graphics Instruction Set) . ReGIS lets you create and store 
pictures as ASCII text and efficiently send those pictures to 
remote displays. The VT125 also has an auxiliary data port for 
making hard copies of the display with the DECwriter IV Graphics 
printer. For users who have programs for the older VT105, the 
VT125 includes a VT105 emulator. 

BOOK INTRODUCTION 

This book describes the following products: 

VT125-AA and AB Graphics Terminal 

VTIXX-CB and -CL Graphics Processors for VT100 and VT105 

This user Guide provides general operating information, interface 
information, control function and ReGIS command descriptions, and 
specific installation and checkout procedures. The main audiences 
for this book are the terminal installer, the application 
programmer and the operator. The operator, however, should use 
this book only as a reference when operating the terminal. The 
document which describes the use of the application software is 
the primary document for the operator. 

The information in this user guide is divided by function. This 
allows you to refer to a specific chapter according to the 
function to be performed. The chapters are arranged by frequency 
of use. Since operating information is frequently used by the 
operator it is at the beginning. Installation is performed only 
once so it is placed toward the end of the book. 

This VT125 User Guide is written for three types of readers: 

• the operator needing general operating information, 
(Chapters 1, 2, 3, 9, and 11) 



Xlll 



• the applications programmer needing ReGIS, VT105, control 
function and communications descriptions, (Chapters 4, 5, 
6, 7) 

• and the hardware installer needing specific installation 
and checkout information (Chapters 8, 9, 10 and 11). 

Chapter 1 provides a general introduction of how the terminal 
operates and shows all the controls and indicators of the 
terminal. This chapter gives the reader a summary of the basic 
terminal operation. Detailed operating information may depend on 
the computer software. 

Chapter 2 defines SET-UP and describes each SET-UP feature in 
detail. Many of the SET-UP features of the terminal change the way 
the terminal communicates with the computer. Detailed information 
on communication and the related SET-UP features is provided in 
the Communication chapter. 

Chapter 3 describes the characters and codes transmitted by the 
terminal, and shows the keys required to produce the codes. 

Chapter 4 explains to the programmer the use of control functions 
to control the display, processing, transmission and 
representation of characters by the terminal. The chapter includes 
a description of the characters received by the terminal. 

Chapter 5 provides the syntax and commands of the ReGIS graphics 
descriptor. 

Chapter 6 provides the syntax and commands of the VT105 emulator. 

Chapter 7 describes the types of communication interfaces 
available on the VT125. This chapter also describes the methods of 
communicating with the graphics option, the computer and the 
printer, and describes the SET-UP features used with these 
devices. 

Chapter 8 describes the environmental conditions which should be 
considered before installing the terminal. A detailed installation 
procedure is provided. The chapter also has a step-by-step 
procedure for turning on the terminal and checking that it 
operates correctly. 

Chapter 9 describes all operator maintenance procedures used with 
the VT125. Also provided is information on self-testing. This 
information outlines the steps needed to start the built-in tests 
and understand the results once the tests have run. The chapter 
also has a general procedure for operator troubleshooting of the 
terminal . 

Chapter 10 describes the VT125 options: the Advanced Video option 
and the current loop interface adapter, the VTIXX-CB and -CC 
Graphics Processor upgrades for the VT100 and VT105, and provides 
installation and checkout instructions. 
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Chapter 11 describes the accessories and supplies offered for use 
with the VT125. Included in this chapter is a short description of 
each accessory and supply, part number and ordering information. 

Appendix A lists the specifications of the VT125 terminal. 

Appendix B is a summary of the SET-UP feature display. 

Appendix C lists the character codes generated by the VT125 
terminal . 

Appendix D is a summary of the VT125 control functions and ReGIS 
commands . 

Appendix E describes the ANSI code extension techniques used to 
create escape and control sequences. 

Appendix F describes how to write ReGIS commands for both the 
VT125 and the VK100. 

Appendix G explains the HLS color system in the VT125. 

Appendix H lists the ReGIS commands used to create art for this 
book . 

Glossary is a list of technical words and their definitions. 

Other Terminals is a list and description of terminals offered by 
DIGITAL. 

Warranty Information describes the warranty and services available 
from DIGITAL. 

BOOK METHODS 

This book uses a colored shading to indicate certain features and 

concepts. This usually indicates a table in the text. 

Notes, Cautions, and Warnings — A note contains information that 
is important enough to set off from the main body of text. A 
caution contains information essential to the safety of the 
equipment and software. A warning contains information essential 
to the safety of personnel. 
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CHAPTER 1 
OPERATING INFORMATION 



GENERAL 

This chapter has a general overview of how the VT125 operates and 
a description of the controls and indicators of the terminal. Also 
provided is a summary of basic operating procedures. Detailed 
operating information depends on the computer and software that 
the terminal is connected to. 

TERMINAL OPERATION 

The VT125 Graphic Terminal is a VT100 (Figure 1-1) video text 
terminal and a Graphics Processor in one package. The Graphics 
Processor processes graphic commands from a computer to generate 
an image in its own memory. Then it sends a video representation 
of that image to the VT100 text terminal's internal monitor screen 
and to an optional external color monitor. It can also send a bit 
map representation of the image to a graphic printer. If data 
coming to the VT125 is not graphic commands or other commands to 
the Graphics Processor, the Graphics Processor sends the data to 
the VT100 for processing and display as text or VT100 control 
functions. 

CONTROLS AND INDICATORS 

The VT125 video terminal has many different controls and 

indicators. The controls and indicators are explained in four 

groups: 

Monitor Controls 
Keyboard Controls 
Visual Indicators 
Audible Indicators 

Monitor Controls 

The VT125 terminal has two controls that are located on the rear 
panel. The controls are the AC Voltage Selection switch and the AC 
Power ON/OFF switch. Their locations are shown in Figure 1-2. 

AC Voltage Selection switch — The AC Voltage Selection switch 
lets the VT125 terminal operate with the available AC input 
voltage. See Installation (Chapter 8) for more information. 

CAUTION; Setting the AC Voltage Selection switch to 120 VAC when 
using 198 to 256 VAC power source will damage the terminal. 
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Figure 1-1 VT125 Graphics Terminal 
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Figure 1-2 Monitor Controls and Connector Locations 



1-2 



NOTE: The Voltage Selection switch does not select the AC line 
frequency Power SET-UP feature. Refer to the SET-UP chapter for 
more information. 

AC Power ON/OFF switch — The AC Power ON/OFF switch turns ON and 
OFF the AC power to the terminal. Either the ON LINE or LOCAL 
keyboard indicators light to show the AC power ON condition. Refer 
to the indicators section of this chapter for more information on 
the VT125 indicators. 

A Power Up Self Test verifies the proper operation of the VT125 
terminal each time the terminal is powered up. Perform the 
following procedure to power up and checkout the terminal: 

1. Turn the Power switch to the on position (refer to Figure 
1-2 for the switch location) . The terminal automatically 
runs the Power Up Self Test. The test gives the following 
indications : 

• Keyboard and screen flash on and off. 

• All keyboard indicators turn on and off, and either 
the ON LINE or LOCAL indicator is turned on. 

• The Wait message is displayed on the screen and then 
is erased. 

• A bell tone is generated. 

• A band of light appears at the top of the screen and 
is erased. 

• Another bell tone is generated. 

• A message appears to announce the result of the VT125 
self-test, and a box is drawn* around the margins of 
the graphics screen area. (This message stays on the 
screen until the first character arrives over the 
communication line.) 

NOTE: No message appe ar on t h e s c^ e e n_u n t_ j^ j^_ t h£ 
terminal warms up. 

• The text cursor is displayed in the upper-left corner 
of the screen. 

Any error found by the Power Up Self Test is 
displayed on the screen as a character, as a message, 
on keyboard indicators L1-L4, or by several bell 
tones. Refer to the Self Test Error Codes section of 
Chapter 9 for more information about the error 
indications. 

I 

* Not on all units 
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2. If the terminal powers up correctly, select the SET-UP 
features you want as described in Chapter 2. 

Keyboard Controls 

The VT125 keyboard has a typewriter-styled main keyboard and 
calculator-like auxiliary keypad. The main keyboard is arranged 
and operates similar to a standard office typewriter. The 
auxiliary keypad allows rapid entry of numeric data or function 
characters. 

Some keys of the VT125 keyboard cause the generation of one or 
more characters immediately when typed. Other keys such as CTRL 
and SHIFT keys do not cause the generation of characters when 
typed, but modify the characters generated by other keys. If two 
character-generating keys are pressed almost at the same time so 
that they are down at the same time, two characters are generated 
according to the order in which the keys were typed. The VT125 
does not wait for the keys to be lifted, but generates both 
characters as soon as possible after the keys are typed. If three 
character-generating keys are pressed at the same time, the 
characters from the first two keys are generated immediately; the 
character for the third key is generated when one of the first 
keys is lifted. 

The keyboard keys are divided by function: 

Standard Keys 
Function Keys 
SET-UP Keys 

Standard Keys — Figure 1-3 identifies those keys of the VT125 
keyboard that are labeled as standard typewriter and calculator — 
like keys. The codes transmitted by each of these keys under 
various conditions are described in the Terminal Transmissions 
chapter. 

Also, some of the standard typewriter and calculator keys, when 
used as function keys, may generate control characters. See 
Chapter 3 for a figure showing the control character generated by 
each key and see the computer software user guide for the meaning 
of the keys. 

CAPS LOCK Key 

When pressed the CAPS LOCK key causes the generation of uppercase 
alphabetic characters regardless of the position of the SHIFT key. 
The CAPS LOCK key locks into position during operation. To release 
the CAPS LOCK key, press the key again. 

The numeric and special symbol keys are not affected by the CAPS 
LOCK key. The CAPS LOCK key does not affect the auxiliary keypad. 

SHIFT Keys 

When pressed the SHIFT keys cause the generation of uppercase 
characters for the alphabetic, numeric and special symbol keys of 
the main keyboard. The SHIFT key does not affect the keys of the 
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Figure 1-3 Standard Keys 
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auxiliary keypad or Tab, Return, Linefeed, Backspace, Delete, or 
Space Bar (unlabeled) . 

Auxiliary Keypad Keys 

The auxiliary keypad lets you enter numbers into the VT125 as if 
it is a calculator. The minus, comma, period and numeric keys of 
the auxiliary keypad usually generate the same characters as the 
corresponding unshifted keys of the main keyboard. The ENTER key 
corresponds to the RETURN key of the main keyboard. 

Function Keys -- Figure 1-4 identifies the function keys of the 
VT125. The following paragraphs provide general descriptions of 
these keys. 

ESC Key 

When pressed the ESC key causes the generation of the escape 

character . 

TAB key 

When pressed the TAB key causes the generation of the tab 

character. 

CTRL Key 

When pressed in combination with another key, the CTRL key causes 
the VT125 to generate control characters. Figure 3-3 in Chapter 3 
shows which key to press for each control character. 

DELETE Key 

When pressed the DELETE key causes the generation of a delete 
character. The deleted character may or may not be erased from the 
screen depending on the computer's software. 

RETURN Key 

When pressed the RETURN key causes the generation of either a 
carriage return (CR) or a carriage return and line feed (CRLF) . 
The characters generated are selected using the Line Feed/New Line 
SET-UP feature. Refer to the SET-UP chapter for more details on 
this SET-UP feature. 

LINE 
FEED Key 

When pressed the LINE FEED key causes the generation of a line 
feed character. 

NO 

SCROLL Key 

When first pressed during the transmission of characters from the 
computer through the Graphics Processor to the VT125, the NO 
SCROLL key stops the VT100 from processing characters. The 
contents of the text display is held in place and scrolling stops. 
Other activities such as graphics processing or printing may 
continue. When the NO SCROLL key is pressed a second time, the 
VT100 continues processing characters, the screen displays the new 
characters, and scrolling continues. 
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Figure 1-4 Function Keys 
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BREAK Key 

The BREAK key causes the generation of a BREAK signal. Refer to 
the Communication chapter for details on the use of the BREAK 
signal. The computer response to the BREAK signal depends on the 
computer and software. See the computer software user guide for 
details on the use of this key. 

When pressed while pressing the SHIFT key, the BREAK key causes a 
Long Break disconnect. Refer to Communication chapter for details 
on Long Break disconnects. 

When pressed while pressing the CTRL key, the BREAK key causes the 
VT100 Answerback message to be transmitted. Refer to the SET-UP 
chapter for more details on the Answerback message. 

T t > < Keys 

These keys usually generate cursor control commands. The cursor is 
an indicator on the video screen that shows the line and column 
where the next character is positioned. Each of these keys causes 
the generation of characters which may hav.e a special meaning to 
the computer. See the computer software user guide for details on 
the use of these keys. 

Auxiliary Keypad 

The auxiliary keypad can be used in two ways depending on your 

computer software: 

• For entering numbers (only PFl , PF2, PF3, PF4 are 
function keys) 

• For special purposes such as video editors (all keys are 
function keys) 

See Chapter 3 for an explanation of the different kinds of keypad 
function keys. Refer to the computer software user guide for more 
information on the use of these keys. 

SET-UP Keys — Figure 1-5 identifies the keys which have meaning 
to the VT125 when operating .in SET-UP. There are two SET-UP 
displays: SET-UP A, and SET-UP B. The SET-UP chapter has a 
detailed explanation of the use of these keys. 

SET-UP Key 

When pressed the SET-UP key places the VT125 in SET-UP. While in 
SET-UP the terminal features can be changed. Entering and exiting 
SET-UP also cancels any ReGIS Hard Copy command. 

@ 
SET/CLEAR TAB 2 Key 

In SET-UP A the SET/CLEAR TAB key sets or clears single horizontal 
tabs. In SET-UP B this key is inactive. 
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# h 

CLEAR ALL TABS 3 Key 

In SET-UP A, this key clears all horizontal tabs set. In SET-UP B 

this key is inactive. 

$ 
LINE/LOCAL 4 Key 

In any SET-UP display the LINE/LOCAL key switches the VT125 
between ON LINE and LOCAL. While ON LINE the VT125 communicates 
with the computer through the graphics option. While LOCAL the 
VT125 cannot communicate with the computer. Instead, the VT100 
terminal inside the VT125 communicates only with itself, ignoring 
the graphics option. However, the graphics option can continue to 
process data from the computer. Use a data loopback connector with 
the terminal ON LINE to communicate with the graphic option from 
the keyboard. See the Maintenance Chapter for instructions. 

% 
SET-UP A/B 5 Key 

In SET-UP the SET-UP A/B key switches the VT125 between SET-UP A 
and SET-UP B. 



TOGGLE 1/0 6 Key 

In SET-UP B the TOGGLE 1/0 key turns the selected feature on or 
off. In SET-UP A this key is inactive. 

& 
TRANSMIT SPEED 7 Key 

In SET-UP B the TRANSMIT SPEED key steps the VT125 up through the 
transmit baud rate settings of the line to the computer. In SET-UP 
A this key is inactive. 

* 
RECEIVE SPEED 8 Key 

In SET-UP B the RECEIVE SPEED key steps the VT125 through the 
receive baud rate settings of the line to the computer. In SET-UP 
A this key is inactive. 

( 
80/132 COLUMNS 9 Key 

In SET-UP A the 80/132 COLUMN key switches the display line size 
between 80 and 132 characters per line. In SET-UP B this key is 
inactive. 

) 
RESET Key 

In any SET-UP display the RESET key starts the reset sequence. 
This has the same result as turning the VT125 power off and then 
on. 

NOTE; The Reset sequence erases the VT125 memory. This includes 
the text and graphics display data, any temporarily stored SET-UP 
feature settings, and any selected graphics protocols? 
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T y Keys 

In any SET-UP display the T (up arrow) and V (down arrow) keys 
raise and lower the brightness of the display. 

< > Keys 

In any SET-UP display the < (left arrow) and > (right arrow) keys 

move the cursor left and right. 

A Key 

In SET-UP B, while pressing the SHIFT key press the A key to enter 
the answerback message in the VT125. 

R Key 

In any of the SET-UP displays, while pressing the SHIFT key, press 
the R key to recall the previously stored user permanent memory 
SET-UP feature selections. 

S Key 

In any of the SET-UP displays, while pressing the SHIFT key, press 
the S key to store the current SET-UP feature selections in the 
user permanent memory. See the SET-UP chapter for more details. 

Keyboard Indicators 

Figure 1-6 shows the location of the keyboard indicators. The 
following paragraphs describe the function of each indicator. 

ON LINE Indicator 

This indicator lights to show that the text terminal is ON _ LINE 
and ready to transmit or receive data. When AC power is ON, either 
the ON LINE or LOCAL indicator is ON. 

LOCAL Indicator 

This indicator lights to show that the text terminal is LOCAL and 
cannot communicate with the computer or the graphics option. When 
the text terminal is LOCAL, it displays data entered from the 
keyboard on the screen as if the data came from the computer. When 
AC power is ON, either the ON LINE or LOCAL indicator is ON. LOCAL 
should only be used to test the text terminal. Always leave the 
terminal ON LINE. 

KBD LOCKED Indicator 

This indicator lights to show that the keyboard has been turned 
off (locked) either by the computer or by the terminal itself. Any 
new characters typed are lost. The terminal can seill receive data 
from the computer. 

The computer turns off the keyboard if it cannot process 
characters as fast as the terminal sends them. The computer turns 
the keyboard on when it is ready for more characters. 

The terminal turns off the keyboard if the transmit baud rate is 
too slow to send characters as fast as you type them. The terminal 
turns the keyboard on after it sends the characters you already 
typed. 
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Figure 1-6 Keyboard Indicators 
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NOTE; If you enter and exit SET-UP while the keyboard is locked, 
characters already typed are lost and the keyboard is unlocked. 
However, if the computer is not ready to receiv e characters, 
characters typed after unlocking may be lost. 

LI - L4 

These indicators are turned on and off by the computer. See your 
computer software instructions for the meaning of each indicator. 
LI - L4 also show self-test errors. 

Audible Indicators 

There are three audible indicators in the VT125; a keyclick, a 
long tone (beep), and a series of long tones. 

Keyclick — The terminal generates a keyclick when a key is 
pressed, with the following exceptions: 

— SHIFT or CTRL keys do not generate any keyclick because 
these keys do not transmit characters but only modify the 
characters transmitted by other keys. 

KBD LOCKED indicator is on; any keys typed are lost. 

The keyclick feature is off in SET-UP B. 

Long Tone (beep) The terminal generates a beep to indicate one of 
the following conditions: 

A bell character was received from the computer. 

The cursor is eight characters away from the right margin 
and the margin bell feature is enabled. 

Series of Long Tones 

The terminal generates the long tone many times in a row and the 
screen displays "2" to indicate that the user permanent memory 
cannot read or write the SET-UP features. If this happens, check 
the SET-UP features and then perform the Save or Recall operation 
again. Service may be needed. See Chapter 9. 
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CHAPTER 2 
SET-UP FEATURES 



GENERAL 

The VT125 terminal has many features in SET-UP that allow the 
terminal to be configured for specific applications. This chapter 
describes SET-UP and each of the SET-UP features. 

SET-UP FEATURES 

SET-UP features change how the VT125 terminal operates. They allow 
the terminal to be configured to operator preference, and they 
provide compatibility to the computer and ac power source. Table 
2-1 divides the SET-UP features into three general types: operator 
preference, communication compatibility, and installation. 



Table 2-1 SET-UP Feature Types 



SET-UP Feature 

ON LINE/LOCAL 
Screen brightness 
Columns per line 
Tab stops 



Operator 
Preference 



X 



Communication 
Compatibility 



Installation 



X 

X 
X 



Scroll X 

Auto repeat X 

Screen background X 

Cursor X 



Margin bell 
Keyclick 
ANSI/VT52 
Auto XON/XOFF 



X 
X 



X 
X 



US/UK character set 

Auto wrap 

Line feed/new line 

Interface 



X 
X 



Parity sense 

Parity 

Bits per character 

Power 



X 
X 
X 



X 
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Table 2-1 SET-UP Feature Types 



SET-UP Feature 



Operator 
Preference 



Communication 
Compatibility 



Installation 



AUX port bits 

character 

AUX port speed 

Transmit speed 

Receive speed 

Answerback 



per 



X 

X 
X 
X 
X 



Operator Preference Features 

These features configure the terminal to operator preference. They 
do not affect information transferred between the terminal and the 
computer. 

Communication Compatibility Features 

These features configure the terminal so that it is compatible 
with a computer. There are many combinations of SET-UP features 
used when communicating with a computer. The features must be 
selected correctly for the terminal to communicate with the 
computer. An error in these selections may stop communication or 
cause incorrect information to be transferred between the terminal 
and computer. 

NOTE; This chapter describes the SET-UP features used to provide 
compatibility. More information about using these SET-UP features 
is provided in Chapter 7. 

Installation Features 

These features configure the terminal for operation in different 
installations. If the location of the terminal is changed, verify 
these feature selections. 

FEATURE SELECTION 

SET-UP features can be selected by the computer or from the 
terminal keyboard. When the computer changes the feature 
selections, the SET-UP features are not destroyed. However, the 
current selection is shown by the SET-UP feature display. SET-UP 
features that can be changed by the computer are listed in Table 
2-2. Refer to Chapter 4 for more information about the selection 
of features by the computer. 

To select SET-UP features from the keyboard you must enter SET-UP. 
SET-UP has two feature displays: SET-UP A and SET-UP B (Figure 
2-1. The SET-UP A feature display shows the location of tab stops 
and a visual ruler numbers each column of the line. The SET-UP B 
feature display shows the other SET-UP features. Use the following 
steps to change a SET-UP feature selection. 
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Table 2-2 SET-UP Features the Computer Can Change 

SET-UP Feature Can be Changed 

ON LINE/LOCAL 

Screen brightness 

Columns per line X 

Tab stops X 

Scroll X 

Auto repeat X 

Screen background X 
Cursor 

Margin bell 

Keyclick 

ANSI/VT52 X 

Auto XON/XOFF 

US/UK character set X 

Auto wrap X 

Line feed/new line X 

Interface X 

Parity sense 

Parity 

Bits per character 

Power 

AUX port bits per character 

AUX port speed 

Transmit speed 

Receive speed 

Answerback 
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Figure 2-1 SET-UP Displays 
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Procedure Indication/Comments 

Press the SET-UP key SET-UP A is displayed on the screen, 
to enter SET-UP. 

Press SETUP A/B to The selected SET-UP display shows on the 

select the correct screen. 
SET-UP display. 

Change the SET-UP The SET-UP display shows the feature 

feature selection. selection. 

Store the SET-UP The terminal displays wait and then 

features if desired. SET-UP A. 

Press SET-UP to exit 
SET-UP. 



NOTE: 


Entering 


and exiting 


SET- 


UP 


with 


KBD 


LOCKED 


on clears 


the 


keyboard 


locke 


d condition 


and 


erases 


any 


characters 


that were 


typed 


aft 


er the 


keyboard was locke 


d. En 


tering and 


exiting SET 


-UP 



also cancels any ReGIS Hard Copy command. 

ENTERING AND EXITING SET-UP 

You can enter SET-UP while either ON LINE or LOCAL. 

FEATURE MEMORIES 

The SET-UP feature selections are stored in three memories: 

operating (temporary), user permanent, and default (Figure 2-2). 

Operating Memory 

This memory stores the SET-UP feature selections used to operate 
the terminal. The terminal always operates according to these 
features. The features can be selected at the terminal keyboard or 
by the computer. In SET-UP, the feature selections in the 
operating memory are shown on the screen. To change the SET-UP 
feature selections stored in memory perform the following 
procedure at the terminal keyboard. 

Procedure Indication/Comments 

Press the SET-UP key SET-UP A is displayed on the screen, 
to enter SET-UP. 

Press SETUP A/B to The selected SET-UP display shows on the 
select the correct screen. 
SET-UP display. 

Change the SET-UP The SET-UP display shows the feature 
feature selection. selection. 

Press the SET-UP key The terminal operates according to the 
exit SET-UP. new SET-UP feature selections in 

operating memory. 
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Figure 2-2 SET-UP Feature Memories 
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If a recall or reset procedure is performed, or power to the 
terminal is turned off and on, all operating memory SET-UP feature 
selections are replaced by the SET-UP feature selections in user 
permanent memory. 



User Permanent Memory 

This memory stores selected SET-UP features permanently. The 
computer cannot change SET-UP feature selections in user permanent 
memory. User permanent memory can only be changed by performing a 
store from the terminal keyboard while in SET-UP. Turning power 
off does not affect SET-UP feature selections in this memory. 
SET-UP features are moved between operating memory and user 
permanent memory by performing store, recall, or reset procedures. 

Store — This procedure stores the operating memory SET-UP feature 
selections in user permanent memory. Storing is performed from the 
terminal keyboard. The computer cannot store SET-UP feature 
selections in user permanent memory. To store SET-UP feature 
selections in user permanent memory, perform the following 
procedure. 



Procedure 

Press the SET-UP key 
to enter SET-UP. 



Indication/Comments 

SET-UP A is displayed on the screen, 



Hold down the SHIFT 
key, press the S key; 
then release both keys, 



The terminal displays wait and then 
SET-UP A. 



Press the SET-UP key 
to exit SET-UP. 

Recall — This procedure recalls the user permanent memory SET-UP 
feature selections into operating memory. All feature selections 
previously in operating memory are erased. Also, the text screen 
memory is erased. To recall the SET-UP feature selections from 
user permanent memory into operaing memory, perform the following 
procedure. 



Procedure 



Indication/Comments 



Press the SET-UP key 
to enter SET-UP. 



SET-UP A is displayed on the screen. 



Hold down the SHIFT key. The terminal displays wait and then 
press the R key; then SET-UP A. 
release both keys. 

Press the SET-UP key 
to exit SET-UP. 

NOTE; Some features selected by the computer may be affected, 
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Reset — This procedure resets the terminal, erases all memories 
and performs a self-test. Also, reset recalls the user permanent 
memory SET-UP feature selections into operating memory. All 
feature selections previously in operating memory are erased. To 
reset the terminal, perform the following procedure. 

Procedure Indication/Comments 

Press the SET-UP key SET-UP A is displayed on the screen, 
to enter SET-UP. 

Press RESET. The power-on self-test runs. The terminal 

operates according to the SET-UP feature 
selections in user permanent memory. The 
terminal automatically exits SET-UP. 

SET-UP DEFAULT MEMORY 

The VT125 has default SET-UP feature selections for all the VT125 
SET-UP features. These default selections cannot be changed by the 
user. When a default occurs (usually because of a problem in the 
user permanent memory) , all operating memory SET-UP feature 
selections change to the default selections. The SET-UP features 
in user permanent memory are not changed by a default. Figure 2-3 
shows the default SET-UP feature selections. 

SET-UP FEATURE DEFINITIONS 

The SET-UP feature definitions in this section are arranged by the 
SET-UP display in which they are changed. A general procedure for 
changing each SET-UP feature in the SET-UP display is provided at 
the beginning of each SET-UP display section. For features needing 
a more detailed procedure, the procedure is given with the SET-UP 
feature description. The first section includes the general 
features changed in either SET-UP A or SET-UP B. 

NOTE; Entering set-up and changing features usually does not cause 
the loss of characters in the VT125 text memory. Any action that 
does cause loss is explained. — 

General SET-UP Features 

The ON LINE/LOCAL and Screen Brightness SET-UP features may be 
changed in any SET-UP display. Dedicated keys on the main keyboard 
select these features. Each feature description includes the 
specific change procedure. 

ON LINE/LOCAL 

The ON LINE/LOCAL feature places the terminal either ON LINE or 
LOCAL. While ON LINE (the keyboard ON LINE indicator is on) the 
text terminal transfers data to and from the computer through the 
Graphics Processor. 

While LOCAL (the keyboard LOCAL indicator is on) the text terminal 
does not transfer data to or from the Graphics Processor. 
Characters typed on the keyboard are echoed to the screen 
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TABS 
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ON/OFF LINE 

ANSWERBACK 
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LOCAL 

NONE 
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■SCROLL = SMOOTH 
■AUTO REPEAT = ON 
■SCREEN = DARK BACKGROUND 
■CURSOR = BLOCK 



MARGIN BELL = OFF- 

KEYCLICK = ON - 

ANSI/VT52 = VT52- 

AUTO XON XOFF = ON - 
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■ U.S./U.K. CHARACTER SET = U.S. 

■AUTOWRAP=OFF 

-LINE FEED/NEW LINE=OFF 

-INTERLACE =OFF 



PARITY SENSE = EVEN- 
PARITY = OFF - 
BITS PER CHAR = - 
POWER =60Hz - 
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CHAR =7 



II 
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Figure 2-3 SET-UP Default Feature Selections 
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directly. LOCAL should only be used to test the text terminal. 
Always leave the terminal ON LINE. 

Perform the following procedure to select the ON LINE or LOCAL 
condition: 



Procedure 

1. Press the SET-UP 
key to enter SET-UP. 

2. Press the OFF/ON 
LINE key to select 
on-line or off-line. 



Indication/Comments 

SET-UP A is displayed on the screen. 



The ON LINE and OFF LINE keyboard 
indicators show the feature selection. 



3. Press the SET-UP The characters displayed on the screen 
key to exit SET-UP. when entering SET-UP are again displayed 

on the screen. 

SCREEN BRIGHTNESS 

The VT125 electronically controls screen brightness. The T (up 
arrow) key increases the screen brightness; the ^ (down arrow) key 
decreases the screen brightness. 

Perform the following procedure to select the wanted screen 
brightness : 



Indication/Comments 

SET-UP A is displayed on the screen. 



SET-UP display is the brightness 
selected. 



Procedure 

1. Press the SET-UP 
key to enter SET-UP. 

2. Press the T (up 
arrow) or t (down 
arrow0 key to 
select brightness. 

3. Press the SET-UP The characters displayed on the screen 
key to exit SET-UP. when entering SET-UP are again displayed 

on the screen. 

SET-UP A Features 

The following paragraphs describe the SET-UP A features in detail: 

CHARACTERS PER LINE 

The characters per line feature selects a display of either 80 or 
132 characters per line. With 80 characters per line selected, the 
screen is 80 characters wide and 24 lines long. With 132 
characters per line selected, the screen is 132 characters wide 
and 14 lines long (132 characters by 24 lines long if the advanced 
video option is installed). The displayed lines with 132 
characters per line selected are the same width on the video 
screen as the 80 character per line selection but the characters 
are narrow and closer together. Figure 2-4. 
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Figure 2-4 80- and 132-Column Displays 
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NOTE: Changing the characters per line erases the current contents 
of the screen? ~ ~~ 

Perforin the following procedure to select the number of characters 
per line: 

Procedure Indication/Comments 

1. Press the SET-UP SET-UP A is displayed on the screen, 
key to enter SET-UP. 

2. Press the 80/132 The bottom line of the display is a 
COLUMNS key "ruler" which numbers each column 

to select the position on a line. This ruler indicates 
number of columns the feature selection, 
per line. 

3. Press the SET-UP The characters displayed on the screen 
key to exit SET-UP, before entering SET-UP are lost. When 
or press the SET-UP exiting SET-UP the screen is blank. 
A/B key to enter 

SET-UP B. 

TABS 

Tab stops are preselected points on a line of the VT125 display. 
The VT125 cursor can tab (advance) to the tab stops on the display 
line. The tab stops may be changed one at a time, or all cleared 
and then set. 

The 2 (SET/CLEAR TAB) key of the main keyboard sets and clears 
single tab stops. The 3 (CLEAR ALL TABS) key of the main keyboard 
clears all tab stop settings. 

Do the following procedure to set and clear tab stops. 
Procedure Indication/Comments 

1. Press the SET-UP SET-UP A is displayed on the screen, 
key to enter SET-UP. 

2. Press the CLEAR ALL All tabs are cleared. 
TABS key or the 

SET/CLEAR TABS key The tab is set or cleared at the cursor 

position. 

The cursor is moved using the < (left 
arrow), > (right arrow), RETURN, TAB and 
SPACE BAR keys. 

3. Press the SET-UP The characters displayed on the screen 
key to exit SET-UP, when entering SET-UP are again displayed 
or press the SET-UP on the screen. 

A/B key to enter 
SET-UP B. 
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SET-UP B Features 

Figure 2-5 is the SET-UP B summary. The bottom line of the display 
is a row of switches indicating the features selected. Change 
SET-UP feature switch selections using the following procedure. 



Procedure 



Indication/Comments 



Press the SET-UP SET-UP A is displayed on the screen, 
key to enter SET-UP. 



2. 



3. 



Press the SET-UP 
A/B key to enter 
SET-UP B. 



SET-UP B is displayed on the screen. 



4. 



5. 



Position the cursor The cursor is positioned using the < 

over the SET-UP (left arrow) , > (right arrow) , RETURN, 

feature switch to TAB and SPACE BAR keys, 
be changed. 

Use the TOGGLE 1/0 The screen displays the feature 

key to select the selection. 

feature. 



Press the SET-UP 
key to exit SET-UP, 
or press the SETUP 
A/B key to enter 
SET-UP A. 



The characters displayed on the screen 
when entering SET-UP are again displayed 
on the screen. 



The following paragraphs describe the features in the order of 
the switches on the screen. The switches are referred to within 
this chapter by the group and the number of the switch within the 
group. (Example: switch 3-2 is the third group of switches — 
second switch counting from left to right.) The answerback feature 
is listed at the end of the feature descriptions. 

SCROLL Switch 1-1: = Jump, 1 = Smooth 

Scrolling is the up or down movement of lines of text on the 
screen. Scrolling is performed to make room for new lines at the 
bottom or top of the screen. It can be performed in two ways: jump 
scroll or smooth scroll. 

With jump scroll selected, new lines are displayed on the screen 
as fast as the terminal receives them. At the higher baud rates, 
the lines displayed are difficult to read because of their rapid 
movement . 

With smooth scroll selected, there is a limit to the speed at 
which new lines are displayed by the terminal. The movement of 
lines occurs at a smooth steady rate allowing the lines to be read 
as they are displayed on the screen. 



NOTE: Smooth scroll allows a maximum 



added a t _ t h e_ t o p_ o r b o 1 1 o m of the screen. The Auto 



of six lines per second to be 

XON/XOFF 



2-13 



1- H 


o8§S 


CO m 


O CN -* <0 


n ^ CM oi 


r' 00 


II II II II 



~-v^ 



a: < 

°- o 




z 


u. 


en c/3 


N N 




U. Z 


l_ ^- 


X X 


M ,>; 


O O 








II II 


r^ 00 


(D m 



^^^ ^-v^ 



































1 


CM 


1 



11. z 

o o 


LO CO 

> < 


LI- Z 

o o 




II II 


o ^ 


_J 
o 


CM 

1 


O 
X 


>- 

LU 


■z. 
< 


z 
o 

o 



>i 

E 
3 
CO 

OQ 

I 
Eh 
PlI 
03 

in 
I 

CM 

0) 

3 
cn 

•r-l 



2-14 



feature must be supported by the computer t q m a^ k e_^ u£ e^_ t h a t^ 
characters are not lost when smooth scroll is selected. 

AUTO REPEAT Switch 1-2: = off, 1 = on 

The auto repeat feature causes a key to be automatically repeated 
at the rate of about 30 characters per second when the key is held 
down for more than one half second. The auto repeat feature 
affects all keyboard keys except the following: 

SET-UP 

ESC 

RETURN 

ENTER 

NO SCROLL 

CTRL and any key 

When the feature is turned off, only one character is transmitted 
each time the key is pressed. 

SCREEN BACKGROUND Switch 1-3: = Dark, 1 = Light 
The screen background feature of the VT125 determines the 
background of the screen. With dark background selected, the 
display has light characters on a dark background. With light 
background (reverse screen) selected, the display has dark 
characters on a light background. Figure 2-6. 

CURSOR Switch 1-4: = Underline, 1 = Block 

The cursor feature offers a choice of two cursor displays to 
indicate the "active position" or where the next character will be 
put on the screen. The cursor is displayed as either a blinking 
underline (_) or a blinking block (p) . If the advanced video 
option is not installed, this feature, also affects the character 
attribute. See Select Graphic Rendition in Section 2 Chapter 4. 

MARGIN BELL Switch 2-1: = OFF, 1 = ON 

The margin bell feature causes a tone if the cursor is eight 
characters from the end of the current line while typing. The 
margin bell can be turned on or off. 

The margin bell volume is not adjustable. 

KEYCLICK Switch 2-2: = OFF, 1 = ON 

Keyclick is a sound which is generated every time a key is 
pressed. The keyclick of the VT125 can be turned on or off. 
However, research and experience has shown that an operator types 
fewer errors when there is an audible feedback from the keyboard. 

The keyclick volume is not adjustable. 

ANSI/VT52 Switch 2-3: = VT52, 1 = ANSI 

The VT125 terminal follows two different programming standards — 
American National Standards Institute (ANSI) and VT52 compatible. 
With ANSI selected, the VT125 generates and responds to control 
sequences according to ANSI standards X3. 41-1974 and X3. 64-1979. 
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These are characters displayed on a lijht background, 




Figure 2-6 Screen Background 
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with VT52 compatible selected, the VT125 terminal is compatible 
with previous DIGITAL software using the VT52 video terminal. But 
because the Graphics Processor only uses ANSI, at power-up it 
sends the VT52 mode control function to the text terminal to force 
this SET-UP feature to ANSI regardless of the user permanent 
memory setting. After power-up, you must manually set this switch 
to use VT52 modes. 

AUTO XON/XOFF Switch 2-4: = OFF, 1 = ON 

The VT125 Graphics Processor requires the XON (DCl) and XOFF (DC2) 

control characters. Therefore, this feature cannot be turned off. 

See the Communications chapter for more information about XON and 

XOFF. 

U.S. /U.K. CHARACTER SET Switch 3-1: = #, 1 = fc 

The VT125 includes character sets for the United States and the 
United Kingdom. The difference between the two character sets is 
one character, the # (number) or fc (pound) symbol. 

AUTO WRAP Switch 3-2: = OFF, 1 = ON 

The auto wrap feature selects where a received character is 
displayed when the cursor is at the right margin. When the auto 
wrap feature is off, the character and all following characters 
are written into the last column of the current line. When this 
feature is on, the character is automatically displayed on the 
next line. 

LINE FEED/NEW LINE Switch 3-3: = OFF, 1 = ON 
The Line Feed/New Line feature determines the control character (s) 
transmitted when the RETURN key is pressed and what action is 
taken by the VT125 when it receives a line feed control character. 
See Table 2-3. 

When the Line Feed/New Line feature is off (line feed mode) 
pressing the RETURN key generates only the carriage return (CR) 
control character; when a line feed (LF) control character is 
received, the cursor moves down to the next line and maintains the 
current column position. 

When the Line Feed/New Line feature is on (new line mode) , 
pressing the RETURN key generates the carriage return (CR) and 
line feed (LF) control characters. When a line feed control 
character is received, the character is responded to as both a 
carriage return and line feed. Therefore, a received line feed 
causes the cursor to move to the left margin of the next line. 

NOTE: The meaning of line feed varies according to your computer 
system's software. Be sure you need this feature before you turn 
it on . 

INTERLACE Switch 3-4: 0=OFF; 1=0N 

The Interlace feature selects the number of scan lines used to 
create characters on the screen. With Interlace on, the terminal 
uses 480 scan lines per screen. With Interlace off, the terminal 
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Table 2-3 


Line Feed/New Line Feature Summary 


Selection 


Character 
Key Sent 



Off 
Off 
On 

On 

Selection 

Off 

Off 

On 
On 



RETURN 
LINE FEED 
RETURN 

LINE FEED 

Character 
Received 

CR 
LF 



CR 



LF 



Carriage return (CR) 

Line feed (LF) 

Carriage return — line feed 
(CR LF) 

Line feed (LF) 



Function 

Carriage return (cursor moves 
to left margin) 

Line feed (cursor moves to 
next line but stays in same 
column) 

Carriage return (cursor moves 
to left margin) 

Carriage return — line feed 
(cursor moves to left margin 
on next line) 



uses 240 scan lines per screen. This feature does not add any new 
information to the screen. However, when on, the Interlace feature 
may improve the output of hard copy or video devices connected to 
the video output connector. Usually operators prefer to have this 
feature off. 

PARITY SENSE Switch 4-1: = ODD, 1 = EVEN 

The_ parity sense feature defines which of the two methods of 
parity checking, odd or even, is being used by the VT125. If the 
parity feature is on, the terminal's parity sense must be the same 
value as the parity the computer is sending. If the parity sense 
features do not match, most characters sent by the computer are 
rejected even though the character was received correctly by the 
VT125. If a parity error occurs, the checkerboard character {'$ ) 
appears on the screen instead of the received character. 

PARITY Switch 4-2: = OFF, 1 = ON 

Parity, when on, checks received data for correctness and adds a 
parity bit to transmitted data. If a received data error occurs, 
the VT125 can detect it and show its presence by placing a 
checkerboard character S on the screen instead of the character 
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with the error. The parity sense feature determines if the parity 
is even or odd. When parity is off, no parity bit is received or 
transmitted. 

BITS PER CHARACTER Switch 4-3: 0=7 BITS, 1=8 BITS 
This feature allows the terminal to transmit and receive either 7- 
or 8-bit characters. When set for 8-bit operation, bit 8 is set to 
a space (or 0) for characters transmitted and is ignored for all 
characters received. 

POWER Switch 4-4: = 60 Hz, 1 = 50 Hz 

During the initial installation of the VT125, the power feature 
must be set to the power line frequency. In the United States this 
setting is 60 Hz. When using 50 Hz line frequency set this feature 
to 50 hz. 

AUX PORT BITS PER CHARACTER Switch 5-2: 0=7 BITS, 1=8 BITS 
This switch sets the auxiliary port to match the character length 
of your printer or other serial device. When set to 8 bits, the 
eighth bit is a space. This is the same as 7S or 8N on other 
terminals. 

AUX PORT SPEED Switches 5-3 and 5-4 

These switches set the auxiliary port to one of four baud rates: 



XX00 


300 


baud 


XX01 


1200 


baud 


XXI 


2400 


baud 


XXI 1 


9600 


baud 



Set the switches to match the speed of your auxiliary device. 

TRANSMIT SPEED 

Transmit speed must be set to match the computer receive speed. 
The VT125 can transmit at any one of the following speeds: 50, 75, 
110, 134.5, 150, 200, 300, 600, 1200, 1800, 2000, 2400, 3600, 
4800, 9600, 19200 baud. 

Transmit speed is independent of receive speed; the terminal may 
transmit data at one speed and receive data at a different speed. 
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To change the transmit speed, perform the following steps: 
Procedure Indication/Comments 

1. Press the SET-UP SET-UP A is displayed on the screen, 
key to enter SET-UP. 

2. Press the SETUP SET-UP B is displayed on the screen. 
A/B key to enter 

SET-UP B. 

3. Press the TRANSMIT The terminal displays the current feature 
SPEED key to select selection. 

the transmit speed. 

4. Press the SET-UP The characters displayed on the screen 
key to exit SET-UP, when entering SET-UP are again displayed 
or press the SETUP on the screen. 

A/B key to enter 
SET-UP A. 

RECEIVE SPEED 

Receive speed must be set to match the computer transmit speed. 
The VT125 can receive at any one of the following speeds: 50, 75, 
110, 134.5, 150, 200, 300, 600, 1200, 1800, 2000, 2400, 3600, 
4800, 9600, 19200 baud. 

Receive speed is independent of transmit speed; the terminal may 
receive data at one speed and transmit data at a different speed. 

To change the receive speed, perform the following steps: 

Procedure Indication/Comments 

1. Press the SET-UP SET-UP A is displayed on the screen, 
key to enter SET-UP. 

2. Press the SETUP SET-UP B is displayed on the screen. 
A/B key to enter 

SET-UP B. 

3. Press the RECEIVE The terminal displays the current feature 
SPEED key to select selection. 

the receive speed. 

4. Press the SET-UP The characters displayed on the screen 
key to exit SET-UP, when entering SET-UP are again displayed 
or press the SETUP on the screen. 

A/B key to enter 
SET-UP A. 

ANSWERBACK Message 

"he answerback feature provides the VT125 with the capability of 
transmitting an identifying message to the computer. The 
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answerback message is transmitted to the computer under the 
following conditions: 

— The answerback message is transmitted under a direct 
request for identification by the computer. The complete 
answerback sequence happens automatically without 
affecting the screen or requiring operator action. 

The operator manually transmits the answerback message. 
While pressing the CTRL key, press the BREAK key and 
release both keys to manually transmit the answerback 
message. 

Enter an answerback message using the following steps (see Figure 
2-7) : 

Procedure Indication/Comments 

1. Press the SET-UP SET-UP A is displayed on the screen, 
key to enter SET-UP. 

2. Press the SETUP A/B SET-UP B is displayed on the screen, 
key to enter SET-UP 

B. 

3. Hold down the SHIFT The terminal displays A = (refer to 
key, press the A Figure 3-11. 

key and release 
both keys. 

4. Type the message This is any character not used in the 
delimiter character, answerback message. The message delimeter 

character is not transmitted as part of 
the answerback message. 

5. Type the answerback The answerback message may be up to 20 
message. characters. If control characters are 

used they are displayed as the (<>) 
character. 

If a mistake is made while typing the 
message, type the delimiter character 
(used in step 4) and go back to step 3. 
This is the only way to correct errors in 
the answerback message. 

6. If less than 20 If 20 characters are typed, the message 
characters are in is automatically entered into operating 
the message, type memory. If less than 20 characters are 
the delimiter typed the delimiter character is used to 
chracter. enter the message into operating memory. 

7. Press the SET-UP The characters displayed on the screen 
key to exit SET-UP, when entering SET-UP are again displayed 
or press the SETUP on the screen. 

A/B key to enter 
SET-UP A. 
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SET-UP B 

TO EXIT PRESS "SET-UP" 



DELIMITER CHARACTER -j 

\ ANSWERBACK MESSAGE / 
\. \ ,/ 

A= I UP TO 20 CHARACTERS 

1 Qui 2 n 3 H 4 H S H T SPEED 9fi00 R SPEED 9600 



Figure 2-7 Answerback Message 
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CHAPTER 3 
TRANSMITTED CHARACTERS 



GENERAL 

This chapter describes the character codes generated by the VT125 
terminal. The keys are divided into three groups: standard keys, 
function keys, and auxiliary keypad keys. 

STANDARD KEYS 

The standard keys are shown in Figure 3-1. The terminal generates 
American Standard Code for Information Interchange (ASCII) 
character codes. Lowercase ASCII character codes are generated 
when SHIFT or CAPS LOCK are not pressed. Uppercase ASCII character 
codes are generated when either SHIFT or CAPS LOCK are pressed. 
CAPS LOCK does not affect the nonalphabetic keys. 

FUNCTION KEYS 

The function keys are shown in Figure 3-2. These keys generate 
character codes whose function is defined by the computer software 
or communication system. The following paragraphs describe the 
function keys. 

BREAK Key 

The BREAK key generates a BREAK signal. The Break signal function 
is definited by the computer system. Refer to Chapter 5 for more 
information about the Break signal. 



Hold down the SHIFT key, and press the BREAK key to generate a 
Long Break Disconnect. A Long Break Disconnect usually disconnects 
the terminal from the communication line. Refer to Chapter 5 for 
more information about Long Break Disconnect. 

Hold down the CTRL key, and press the BREAK key to generate the 



answerback message. Refer to Chapter 2 
the Answerback SET-UP B feature. 



for more information about 



T t ■< > Cursor Control Keys 

The cursor key character codes generated by the terminal depend on 
the ANSI/VT125 feature selection. When the ANSI/VT125 feature is 
set for ANSI compatibility, the cursor keys generate sequences 
that depend on the cursor key mode selection. Cursor key mode is 
only selected by the computer. Refer to Chapter 4 for more 
information about cursor key character selection. Table 3-1 lists 
the ANSI and VT52 compatible cursor key character codes. 
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OCTAL CODES GENERATED BY KEYBOARD 






















(SHIFTED CODES SHOWN ABOVE KEYCAP LEGENDS 
















UNSHIFTED CODES SHOWN BELOW KEYCAP LEGENDS) 
















041 


1 100 


043 


044 


045 


136 


046 


052 


050 


051 


137 


153 


176 










1 ! 


2(3, 


3# 


4S 


5% 


6 A 


7& 


8 • 


9( 


0) 





= + 


\ - 










061 


062 


063 


064 


065 


066 


067 


070 


071 


060 


055 


075 


140 










121 


127 


105 


122 


124 


131 


125 


111 


117 


120 


173 


175 




-11 








Q 


W 


E 


R 


T 


y 


U 


I 





P 


1 1 


1 1 












161 


167 


145 


162 


164 


171 


165 


151 


157 


160 


133 


135 










CAPS 


101 


123 


104 


106 


107 


no 


112 


1 13 


114 


072 


042 





174 






LOCK 


A 
141 


S 

163 


D 
144 


F 
146 


G 
147 


H 
150 


J 
152 


K 
153 


L 
154 


073 


047 




134 








132 


130 


103 


126 


102 


116 


115 


074 


076 


077 






-1 






SHIFT 


Z 


X 


C 


V 


B 


N 


M 


, < 


> 


/ ? 


SHIFT 










172 


170 


143 


166 


142 


156 


155 


054 


056 


057 










040 








SPACE 
















040 

















Figure 3-1 Standard Key Codes 
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FEED ■ 
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Figure 3-2 Function Keys 
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Table 3-1 Cursor Control Key Codes 



Cursor Key 



T 



Cursor Key 
Mode Reset 



ESC [ A 

033 133 101 

ESC [ B 

033 133 102 



ANSI Mode 
Cursor Key 
Mode Set 



ESC A 
033 117 101 

ESC B 
033 117 102 



VT52 Mode 



ESC A 
033 101 

ESC B 
033 102 



ESC [ C 

033 133 103 

ESC [ D 

033 133 104 



ESC C 

033 117 103 

ESC D 

033 117 104 



ESC C 
033 103 

ESC D 
033 104 



Table 3-2 Comparison of Control Character Generation 



NUL 

RS 

US 



VT125 
Code Keys 



Previous Terminal Keys 



CTRL — Space bar CTRL — § 
CTRL — ~ CTRL — " 

CTRL — ? CTRL — 



Control Character Keys 

Figure 3-3 shows the keys that generate control 

Control characters can be generated in two ways: 



characters , 



1. 



2. 



Hold down the CTRL key, and press any of the unshaded 
keys in Figure 3-3. 

Press any of the shaded keys in Figure 3-3 without using 
the CTRL key. the shaded keys are dedicated keys that 
generate control characters without using CTRL. 

NOTE: The RETURN key character code can be changed by the 

this feature causes 



line feed/new line feature 
RETURN to generate a 



When off , 



single control character (CR) . When 
onT this feature causes RETURN to generate two characters 



(CR, LF) . 
selected , 



Also, depending on the auxiliary keypad mode 
RETURN and ENTER may generate the same control 



codes . 

Table 3-2 lists the control characters that are generated 
differently from previous DIGITAL terminals. No details are 
provided about the function of the control character codes because 
different computer systems may use each control character 
differently. 
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MNEMONICS SHOWN ABOVE KEYCAP LEGENDS 
OCTAL CODES SHOWN BELOW KEYCAP LEGENDS 










HERE 
IS 












ESC 
ESC 
033 


























RS 

\ ~ 

036 


BS 

BACK 
SPACE 

010 


BREAK 




HT 
TAB 
01 1 


XON 

Q 
021 


ETB 
W 
027 


ENQ 

E 
005 


DC2 

R 
022 


DC4 

T 
024 


EM 

Y 

031 


NAK 

U 
025 


HT 

I 

Oil 


SI 



017 


DLE 

P 
020 


1 ESC 

II 
033 


GS 

11 
035 


CR 

ETURN 

015 


DEL 

DELETE 

177 




CTRL 




SOH 

A 
001 


XOFF 

S 
023 


EOT 1 

D 
004 


ACK 

F 
006 


BEL 

G 
007 


BS 

H 

010 


LF 

J 

012 


VT 

K 

013 


FF 

L 
014 






R 


FS 

\l 

034 








SUB 

Z 
032 


CAN 

X 
030 


ETX 

C 
003 


SYN 

V 
026 


SIX 

B 
002 


SO 

N 

016 


CR 

M 

015 


. < 


> 


US 
/? 
037 




LF 

LINE 
FEED 

012 


















NUL 
000 















Figure 3-3 Function Key Control Codes 
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AUXILIARY KEYPAD KEYS 

The characters generated by the auxiliary keypad keys change 
depending on the selection of two features: ANSI/VT52 and 
Alternate Keypad features. The Alternate Keypad feature is usually 
selected only by the computer. Refer to Chapter 4 for more 
information about keypad character selection. 

When alternate keypad mode is not selected (numeric keypad mode is 
selected), the auxiliary keypad generates the numeric, comma, 
period, and minus sign character codes used by the main keyboard. 

NOTE; SHIFT and CAPS LOCK do not affect the codes generated by the 
auxiliary keypad. 

When alternate keypad mode is selected, the auxiliary keypad 
generates control functions. Table 3-3 lists the character codes 
generated by the auxiliary keypad. 



Table 3-3 Auxiliary Keypad Codes 



Numeric 
Keypad 
Key Mode 



ANSI Mode 

Alternate 

Keypad 

Mode 



VT52 Mode 
Numeric Alternate 
Keypad Keypad 

Mode Mode 








060 



ESC 
033 



p 
117 160 




060 



ESC ? P 
033 077 160 



1 
061 



ESC 
033 



q 
117 161 



1 
060 



ESC ? q 
033 077 161 



2 
062 



ESC 
033 



r 
117 162 



2 

062 



ESC ? r 
033 077 162 



3 
063 



ESC 
033 



s 
117 163 



3 
063 



ESC ? s 
033 077 163 



4 
064 



ESC 
033 



t 
117 164 



4 
064 



ESC ? t 
033 077 164 



5 
065 



ESC 
033 



u 
117 165 



5 
065 



ESC ? u 
033 077 165 



6 
066 



ESC 
033 



V 
117 166 



6 
066 



ESC ? V 
033 077 166 



7 
067 



ESC 
033 



w 
117 167 



7 
067 



ESC ? w 
033 077 167 



070 



ESC 
033 



X 

117 170 



8 

070 



ESC ? X 
033 077 170 
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Table 3-3 Auxiliary Keypad Codes (Cont) 



Key 


Numeric 

Keypad 

Mode 


ANSI 


Mode 

Alternate 
Keypad 
Mode 


VT52 Mode 
Numeric Alternate 
Keypad Keypad 
Mode Mode 


9 


9 
071 






ESC 
033 



117 


y 

171 


9 
071 




ESC 
033 


7 
077 


y 

171 


- 


- (minus) 
055 




ESC 
033 



117 


m 
155 


-(minus) 4 
055 


ESC 
033 


7 
077 


m 
155 4 


/ 


, (comma) 
054 




ESC 
033 



117 


1 
154 


, (comma) 4 
054 


ESC 
033 


7 

077 


1 
054 4 


• 


. (period) 
056 




ESC 
033 



117 


n 
156 


. (period) 
056 


ESC 
033 


7 

077 


n 
156 


ENTER* 


CR or 

015 


CR 
015 


LF 
012 


ESC 
033 



117 


M 
115 


CR or 
015 


CR 
015 


LF ESC 
012 033 


7 
077 


M 
115 


PFl 


ESC 
033 



117 


P 

120 


ESC 
033 




117 


P 

120 


ESC 
033 


P 
120 


ESC 
033 


? 
077 


P 
120 


PF2 


ESC 
033 




117 


Q 
121 


ESC 
033 




117 


Q 
121 


ESC 
033 


Q 
121 


ESC 
033 


7 
077 


Q 
121 


PF3 


ESC 
033 



117 


R 
122 


ESC 
033 



117 


R 
122 


ESC 
033 


R 
122 


ESC 
03 


7 

077 


R 
122 


PF4 


ESC 
033 



117 


S 
123 


ESC 
033 



117 


S 
123 


ESC 
033 


s 4 

123 


ESC 
033 


7 
077 


S 4 
123 



* When numeric keypad mode is selected (alternate keypad mode 
off) , the ENTER character code can be changed by the line 
feed/new line feature. When off, this feature causes ENTER to 
generate a single control character (CR, octal 015) . When on, 
this feature causes ENTER to generate two characters (CR, octal 
015 and LF, octal 012) . 

4 These sequences were not available in the VT52. Do not use the 
PF4 , "-" (minus), or "," (comma) keys with VT52 software. 
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CHAPTER 4 
RECEIVED CHARACTER PROCESSING 



GENERAL 

This chapter describes the terminal's response to received data. 
Most of the data are displayable characters that appear on the 
screen with no other effect. But a type of data called control 
functions has important effects on the operation of the terminal. 

A control function is one or more character codes that provide 
control of the transmission, processing, and display of 
characters. Control functions command the VT125 to change its 
operations, for example, by controlling and commanding graphics 
protocols,- changing its response to other control functions, 
erasing parts of the screen, ringing the bell, or selecting 
character sets. The VT125 can also transmit control functions to 
the computer, either with special keys or at the request of the 
computer . 

This chapter explains the implementation of control functions 
using control characters, escape sequences, control sequences, and 
device control strings. This implementation is explained 
according to the standards created by the American National 
Standards Institute (ANSI) and the International Organization for 
Standardization (ISO) . The words used are defined, and all the 
control functions that the VT125 understands are listed and 
explained. For VT125 features that do not have an ANSI standard 
control function, DEC private control functions have been defined 
within the extensions permitted by the ANSI standards. A detailed 
explanation of the format of ANSI control functions is in Appendix 
E. 

Each control function has a unique name, and each name has a 
unique abbreviation. The name and abbreviation are standardized. 
The abbreviation is derived from the name to help the programmer 
remember its meaning, and so it is also called a mnemonic. This 
book lists the mnemonic with the control function name to help the 
programmer . 

ERRORS 

A control function that is not understood by the VT125 is ignored. 
Unsupported control functions (any sequences that meet ANSI 
specifications but are not listed in this book) are generally 
ignored but may produce unexpected responses. 
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If a control character appears in the middle of a sequence 
(including the device control strings of the graphics processor), 
the VT125 uses these rules: 

• XON and XOFF always function as defined in the 
communications chapter. 

• ESC, CAN, and SUB always stop a control function in 
process without consideration of which device was 
receiving the control function. NUL and DEL are fill 
characters when received by the terminal. 

• Any other control characters are understood as part of 
the sequence that they are in. If the communication data 
paths in the VT125 are set to pass the control sequence 
to another device such as the VT100 or the auxiliary 
port, any control characters in the control sequence also 
pass to the other device. Both the text terminal and the 
graphics processor understand a control character inside 
a control sequence as if the control character arrived 
before the control sequence. (The graphics processor 
ignores these other control characters.) 




processor ignores 



ASCII TABLE AND RECEIVED CHARACTERS 

The VT125 terminal processes characters according to the codes 
shown in the ASCII table (Table 4-1) . The ASCII table is a part 
of the ANSI standards. It is the American Standard Code for 
Information Interchange (ASCII) and is also ISO Standard 646 and 
CCITT (Consultive Committee for International Telephone and 
Telegraph) Alphabet 5. Table 4-1 shows each character with its 
binary, octal, decimal, and hexadecimal values. The table is 8 
columns wide and 16 rows long. This arrangment allows binary 
relationships between characters. For example, lower case and 
upper case letters differ only by the value of bit 6. 

The VT125 processes a received character based on the type of 
character as defined by ANSI. Control characters (see next 
section) are all in the first two columns of the table (except 
Delete) . All other characters are displayable characters with the 
exception of Space (SP). SP can be considered either an 
information separator or a displayable character. 

DISPLAYABLE CHARACTERS 

Displayable characters are characters that are displayed on the 
screen when received. The character displayed on the screen 
depends on the character set selection. The character set is 
selected using control functions. Refer to the Character Set 
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Table 4-1 ASCII Table 



B7 
B6 


B5 










1 



1 




1 

1 


1 




1 


1 


1 
1 



1 
1 
1 


BITS 


COLUMN 




1 


2 


3 


4 


5 


6 


7 


B4 B3 B2 Bl 


ROW 








NUL 







DLE 


20 
16 

10 


SP 


40 
32 
20 





60 
48 
30 


@ 


100 
64 
40 


P 


120 
80 

60 


\ 


140 
96 
60 


P 


160 
112 
70 


1 


1 


SOH 


1 
1 

1 


DC1 

(XONl 


21 
17 
11 


f 


41 
33 

21 


1 


61 
49 
31 


A 


101 
65 
41 


Q 


121 
81 
61 


a 


141 
97 

61 


q 


161 
113 
71 


10 


2 


STX 


2 
2 
2 


DC2 


22 
IB 
12 


II 


42 
34 
22 


2 


62 
50 
32 


B 


102 
66 
42 


R 


122 
82 
52 


b 


142 
98 
62 


r 


162 
114 
72 


11 


3 


ETX 


3 
3 
3 


DC3 

(XOFF) 


23 

19 
13 


# 


43 
35 
23 


3 


63 

51 
33 


C 


103 
67 
43 


S 


123 
83 

63 


c 


143 
99 
63 


s 


163 

115 
73 


10 


d 


EOT 


4 
4 
4 


DC4 


24 
20 
14 


$ 


44 
36 

24 


4 


64 
52 
34 


D 


104 
68 
44 


T 


124 
84 
54 


d 


144 
10O 
64 


t 


164 
116 
74 


10 1 


5 


ENQ 


5 
5 
5 


NAK 


25 
21 
15 


% 


45 
37 
26 


5 


65 

53 
35 


E 


105 
69 

45 


U 


125 
85 
56 


e 


145 
101 
65 


u 


165 
117 
75 


Olio 


6 


ACK 


6 
6 
6 


SYN 


26 
22 
16 


& 


46 
38 
26 


6 


66 
54 
36 


F 


106 
70 
46 


V 


126 
86 
56 


f 


146 
102 
66 


V 


166 

118 

76 


111 


7 


BEL 


7 
7 
7 


ETB 


27 
23 

17 


/ 


4/ 
39 
27 


7 


6/ 
55 
37 


G 


107 
71 
47 


w 


127 
87 
57 


g 


147 

103 
67 


w 


167 

119 

77 


10 


8 


BS 


10 
8 
8 


CAN 


30 
24 
18 


( 


50 
40 
28 


8 


70 
56 
38 


H 


110 
72 
48 


X 


130 
88 
58 


h 


150 
104 
68 


X 


170 
120 
78 


10 1 


9 


HT 


11 
9 
9 


EM 


31 
25 
19 


) 


51 
41 
29 


9 


71 
57 
39 


I 


111 
73 
49 


Y 


131 
89 
59 


' 


151 
105 
69 


y 


171 
121 
79 


10 10 


10 


LF 


12 
10 
A 


SUB 


32 
26 

lA 


* 


52 

42 
2A 


■ 


72 
58 
3A 


J 


112 
74 
4A 


z 


132 

90 
5A 


j 


152 
106 
6A 


z 


172 
122 
7A 


10 11 


1i 


VT 


13 
11 
B 


ESC 


33 
27 
IB 


+ 


53 

43 
2B 


1 


73 
59 
3B 


K 


113 
75 
48 


C 


133 
91 
58 


k 


153 
107 
6B 


{ 


173 
123 
7B 


110 


12 


FF 


14 
12 
C 


FS 


34 
28 
1C 


) 


54 
44 
2C 


< 


74 
60 
3C 


L 


114 

76 
4C 


\ 


134 
92 
5C 


1 


154 
108 
6C 


1 


174 
124 
7C 


110 1 


13 


CR 


16 
13 
D 


GS 


35 
29 
ID 


- 


56 
46 
2D 


= 


76 
61 
3D 


M 


115 
77 
4D 


] 


136 
93 
5D 


m 


155 
109 
60 


> 


175 
125 
7D 


1110 


14 


SO 


16 
14 

E 


RS 


36 

30 
IE 


■ 


56 
46 
2E 


> 


76 
62 

3E 


N 


116 
78 
4E 


A 


136 
94 
5E 


n 


156 
110 
6E 


•^^ 


176 
126 
7E 


1111 


15 


SI 


17 
15 

F 


US 


37 

31 
IF 


/ 


67 

47 
2F 


? 


77 
63 
3F 





117 
79 
4F 


— 


137 
95 
5F 


o 


157 
111 
6F 


DEL 


177 
127 
7F 



KEY 



ASCII CHARACTER 




33 


OCTAL 


27 


DECIMAL 


IB 


HEX 
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Selection section of this chapter for more information about 
character sets. 

Control Characters Received 

A control character is a single character which, when received by 
the terminal, starts, modifies or stops a control function. The 
value of a control character is in the octal range of through 37 
and 177. 

The control characters that the VT125 understands are shown in 
Table 4-2 and described in the following paragraphs. All other 
control codes are ignored by the VT125. 

SEQUENCES 

The VT125 is an upward and downward software compatible terminal; 
that is, previous DEC video terminals have DEC private standards 
for escape sequences. The VT125 is compatible with both the 
previous DEC standard and the ANSI standards. Customers may use 
existing DEC software designed around the VT52 or new VT125 
software. The VT125 has a "VT52 compatible" mode in which it 
responds to escape sequences like a VT52. 

Throughout this section of the manual references will be made to 
"VT52 mode" or "ANSI mode". These two terms are used to indicate 
the VT125's software compatibility. All new software should be 
designed around the VT125 "ANSI mode". (All graphics software 
must use ANSI mode.) Future DIGITAL video terminals will not be 
committed to VT52 compatibility. 

All of the following escape and control sequences are transmitted 
from the computer to the VT125 unless otherwise noted. All of the 
escape sequences are a subset of those specified in ANSI 
X3. 64-1979 and ANSI X3. 41-1974. 

Figure 4-1 (at the end of the chapter) is a one-page summary of 
the ANSI mode display control functions. These control functions 
directly or indirectly affect the way the screen looks. 

A summary of all control functions is in Appendix C. 
ANSI SEQUENCES 

1 SET-UP FEATURE AND MODE SELECTION 

SET-UP features are terminal characteristics that can be 
controlled from the keyboard and stored in the user permanent 
SET-UP feature memory. Some SET-UP features can also be changed 
from the computer, but the computer cannot store them in the user 
permanent memory. Some SET-UP features are terminal modes. Table 
4-3 lists the VT125 SET-UP features and modes. 

A mode is a state of the terminal that affects the operation of 
the terminal or how the terminal understands or transmits data. 
Modes are selected by either the computer or the operator. The 
terminal stays in a mode until the computer or operator changes 
the mode setting. 
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Table 4-2 Control Characters Recognized by VT125 



Control 

Character 

Mnemonic 



Octal Name 
Code 



Action Taken 



NUL 

ENQ 
BEL 
BS 

HT 



LF 

VT 

FF 
CR 

SO 

SI 

DCl 
DC3 

CAN 



000 Null. 

005 Enquire. 

007 Bell. 

010 Backspace. 



011 Horizontal 
Tab 



012 Line Feed, 



013 Vertical 
Tab 

014 Form Feed. 

015 Carriage 
Return 

016 Shift Out, 



017 Shift In. 



021 Device 

Control 1 

023 Device 

Control 3 



030 Cancel. 



Ignored on input (not stored in 
input buffer; see full duplex 
protocol) . 

Transmit answerback message. 

Sounds the bell. 

Moves the cursor to the left one 
character position. If it is at 
the left margin, it stays there. 

Moves the cursor to the next tab 
stop, or to the right margin if 
there are no more tab stops in 
the line. 

Causes a line feed or a new line 
operation. (See Linefeed/New Line 
mode) . 

Understood as LF. 

Understood as LF. 

Moves the cursor to the left 
margin on the current line. 

Select Gl character set, as 
designated by a Select Character 
Set sequence . 

Select G0 character set, as 
designated by a Select Character 
Set sequence. 

Understood as XON. Lets terminal 
continue transmission after XOFF. 

Understood as XOFF. Tells terminal 
to stop transmitting all 
characters except XOFF and XON. 

If received during an escape or 
control sequence, cancels the 
sequence and displays the 
substitution character. Any 
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Table 4-2 Control Characters Recognized by VT125 



Control 

Character 

Mnemonic 



Octal Name 
Code 



Action Taken 



SUB 
ESC 

DEL 



032 Substitute. 

033 Escape. 

177 Delete. 



characters from the sequence that 
follow the cancel character are 
displayed after the substitution 
character. 

Understood as CAN. 

Understood as introducer of an 
escape sequence. 

Ignored on input (not stored in 
input buffer) . 



Table 4-3 SET-UP Features and Terminal Modes 







Changeable 


Changable in 


SET-UP Feature 


or 


from 


SET-UP and 


Terminal Mode 




Computer* 


Stored in NVR 


Alternate keypad mode 


Yes 


(DECKPAM) 


No 


ANSI/VT52 mode 




Yes 


(DECANM) 


Yes 


Auto Repeat moc 


ie 


Yes 


(DECARM) 


Yes 


Autowrap mode 




Yes 


(DECAWM) 


Yes 


AUTO XON XOFF 




No 




Yes 


Bits per character 


No 




Yes 


Column mode (Ch 


lar/line) 


Yes 


(DECCOLM) 


Yes 


Cursor 




No 




Yes 


Cursor keys moc 


Ie 


Yes 


(DECCKM) 


No 


Keyclick 




No 




Yes 


Linefeed/New Line mode 


Yes 


(LNM) 


Yes 


Margin bell 




No 




Yes 


Numeric Keypad 


mode 


Yes 


(DECKPNM) 


No 


Origin mode 




Yes 


(DECOM) 


No 


Parity 




No 




Yes 


Parity sense 




No 




Yes 


Power 




No 




Yes 


Auxiliary Port 


Bits per char No 




Yes 


Auxiliary Port 


Speed 


No 




Yes 


Receive speed 




No 




Yes 


Screen mode 




Yes 


(DECSCNM) 


Yes 


Scroll mode 




Yes 


(DECSCLM) 


Yes 


Tabs 




Yes 


(HTS/TBC) 


Yes 


Transmit speed 




No 




Yes 


US/UK Char Set 




Yes 




Yes 



The control or escape sequence 
indicated in parentheses. 



mnemonic that applies is 
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Modes may be changed with the set mode (SM) and reset mode (RM) 
commands, except for Keypad Numeric and Application modes. (These 
modes are changed using dedicated sequences.) Multiple parameters 
may be included in a single command. 



NOTE: 


; The Ps character 


indicates 


a parameter selected 


from a 


list 


of p 


a r ame t e r s . 


Each 


parameter 


1 isted 


represents 


a mode . 


When 


sett 


ing several 


modes 


using 


a 


single 


SM or 


RM se 


iquence , 


the 


parameters are se 


iparated by a 


semicolon 


(octal 


073) . 


The semicolon 



IS not used when selecting only one mode. 
Set Mode Command - SM 



Format: ESC [ Ps;...;Ps h 



Reset Mode Command - RM 



Format: ESC [ Ps;...;Ps 1 



default value: none 

Causes one or more modes to be set 
within the VT125 as specified by 
each parameter in the parameter 
string. Each mode to be set is 
specified by a separate parameter. 
A mode is considered set until it 
is reset by a reset mode (RM) 
control sequence or in SET-UP. 



default value: none 



The following is a list 
Set Mode and Reset Mode. 

ANSI Specified Modes 

Mode 
Parameter Function 



Resets one or more VT125 modes as 
specified by each parameter in the 
parameter string. Each mode to be 
reset is specified by a separate 
parameter . 

of VT125 modes that may be changed with 



Mode 
Mnemonic 




20 



Error (ignored) 

Auto Linefeed/New Line mode LNM 



DEC Private Modes 



NOTE: The first character in the DEC private parameter string is ? 



(77(8)) . 


The 


parameters are 


i understood 


accor 


ding to 


Table 


4-4. 


. Any 


other parameter values are 


ignored. 


AM) a 


nd Keypad Numeric 




NOTE: Ke 


lypad 


1 Application 


Mode (DECKP 


Mode 


(DECKNM) 


are 


changed using 


two special 


two- 


-character se 


quences; 



not the usual Set and Reset Mode sequences, 
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Table 4-4 DEC Private Modes 





Mode 




Mode 


Parameter 


Function 




Mnemonic 





Error (ignored) 




1 


Cursor key 




DECCKM 


2 


ANSI/VT52 




DECANM 


3 


Column 




DECCOLM 


4 


Scrolling 




DECSCLM 


5 


Screen 




DECSCNM 


6 


Origin 




DECOM 


7 


Auto wrap 




DECAWM 


8 


Auto repeati 


ng 


DECARM 



The modes in Table 4-5, which are specified in the ANSI X3. 64-1979 
standard, may be considered to be permanently set, permanently 
reset, or not applying, as indicated. Refer to that standard for 
more information about these modes. 

The following modes are listed alphabetically by name (see Table 
4-3) . 

ANSI/VT52 Mode (DEC Private) — DECANM 

This mode changes the cursor key and auxiliary keypad codes. See 
Tables 4-6 and 4-8. This mode must be set to ANSI or the graphics 
processor cannot work. 



Set: (From VT52 Mode) ESC < 



The set state causes only ANSI 
escape and control sequences to be 
understood and executed. 



Reset: ESC[?21 



The reset state causes only VT52 
compatible escape sequences to be 
understood and executed. 



Auto Repeat Mode (DEC Private) - DECARM 



Set: ESC[?8h 



The set state causes keyboard keys 
to auto-repeat except SET-UP, ENTER, 
ESC, RETURN, NO SCROLL, and CTRL 
with any key. 



Reset: ESC[?81 



The reset state causes no keyboard 
keys to auto-repeat. 
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Table 4-5 Permanently Selected Modes 



Mode 
Name 



Mode 
Mnemonic 



State 



Control representation 



Editing boundary 



Erasure 



Keyboard action 



CRM 



EBM 



ERM 



Format effector action FEAM 



Format effector transfer FETM 

Guarded area transfer GATM 

Horizontal editing HEM 

Insertion-replacement IRM 



KAM 



Multiple area transfer MATM 
Positioning unit PUM 



Selected area transfer SATM 
Status reporting transfer SRTM 



Reset 

Control functions are 
performed without displaying 
a chracter to represent the 
control function received. 

Reset 

Characters moved outside the 
margins are lost and erasing 
and cursor positioning 
functions are not performed 
outside the margins. 

Set 

All characters displayed can 

be erased. 

Reset 

Control functions that affect 
the screen display are 
performed immediately. 

NA 

NA 

NA 

Reset 

Received characters replace 

the characters at the cursor 

position. 

Reset 

Typed characters are 
processed except when the 
keyboard is locked. 

NA 

Reset 

Horizontal and vertical 
parameters in control 
functions are specified in 
units of character positions. 

NA 

Reset 
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Table 4-5 Permanently Selected Modes (Cont) 



Mode 
Name 



Mode 
Mnemonic 



State 



Tabulation stop 



TSM 



Transfer termination 
Vertical editing 



TTM 
VEM 



Status reports are 
transmitted by the VT125 
using the Device Status 
Report (DSR) sequence. 

Reset 

The tab stop selection apply 
to the corresponding column 
of all lines on the screen. 

NA 

NA 



Table 4-6 Cursor Control Key Codes 



Cursor 


Key 


Cursor 


Key 


Cursor Key 


(arrow) 




Mode Reset 


Mode Set 


Up 




ESC [A 




ESC A 


Down 




ESC [B 




ESC B 


Right 




ESC [C 




ESC C 


Left 




ESC [D 




ESC D 



Autowrap Mode (DEC Private) - DECAWM 
Set: ESC[?7h 



Reset: ESC[?71 



The set state causes any displayable 
characters received when the cursor 
is at the right margin to advance to 
the start of the next line, doing a 
scroll up if needed and if the 
cursor has not been positioned 
outside of the scrolling region. 



The reset state causes characters 
received while the cursor is at the 
right margin to replace any previous 
characters there. 



Column Mode (DEC Private) - DECCOLM 
Set: ESC[?3h 



The set state causes a maximum 
132 columns on the screen. 



of 
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Table 4-7 Linef eed/Newline Mode 



Linefeed/ 
New Line Mode 



Key Pressed 



RESET 






RETURN 


RESET 






LINEFEED 


SET 






RETURN 


SET 






LINEFEED 


Linefeed/ 






New Line 


Mode 


Code Rec 


RESET 






CR 


RESET 






LP 


SET 






CR 


SET 






LF 



Code Sent 



CR 
LF 

CR LF 
LF 



Action Taken 

Return 
Linefeed 

Return 

Return - Linefeed 



Reset: ESC[?31 



The reset state causes a maximum of 
80 columns on the screen. 



Cursor Keys Mode (DEC Private) - DECCKM 

This mode only has effect when the terminal is in ANSI mode, 

Table 4-6 shows the sequences generated by each key. 



Set: ESC[?lh 



Reset: ESC[?11 



The four cursor keys send 
application control functions 



The four cursor keys send ANSI 
cursor control commands. 



Linefeed/New Line Mode - LNM 

This mode does not affect Index or Next Line. See Table 4-7. 



Set: ESC[20h 



The set state causes received line 
feed (LF) to move the active 
position to the first position of 
the following line and causes the 
return key (CR) to send the two 
codes (CR, LF) . 



Reset: ESC[20l 



The reset state causes line feed to 
move the active position down only, 
and causes the return key to send 
the single code CR. 
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These are characters displayed usinj 80 colupins. 



Ihese are characters displaijed usinj 132 coluins, 
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Table 4-8 ANSI Mode Auxiliary Keypad Codes 



Key 



Keypad 
Numeric 



Mode 



Keypad 
Application Mode 





1 

2 

3 

4 

5 

6 

7 

8 

9 

- (minus) 

, (comma) 

. (period) 

ENTER 

PFl 

PF2 

PF3 

PF4 






ESC 


P 


1 


ESC 


q 


2 


ESC 


r 


3 


ESC 


s 


4 


ESC 


t 


5 


ESC 


u 


6 


ESC 


V 


7 


ESC 


w 


8 


ESC 


X 


9 


ESC 


y 


- (minus) 


ESC 


m 


, (comma) 


ESC 


1 


. (period) 


ESC 


n 


Same as RETURN key 


ESC 


M 


ESC P 


ESC 


P 


ESC Q 


ESC 


Q 


ESC R 


ESC 


R 


ESC S 


ESC 


S 



Keypad Application Mode (DEC Private) - DECKPAM 
Format: ESC = 



The auxiliary keypad keys and cursor 
control keys transmit escape 
sequences. Table 4-8 lists the 
sequences . 

Keypad Numeric Mode (DEC Private) - DECKPNM 

Format: ESC > 

The auxiliary keypad keys send ASCII 
codes corresponding to the 
characters on the keys (except for 
the PF keys and enter) . The cursor 
control keys send cursor controls. 
Table 4-8 lists the sequences. 

NOTE; In ANSI mode, if the codes are echoed back to the VT125, or 
if the terminal is LOCAL, the last character of the sequence is 
displayed on the screen; for example, PFl is displayed as a "P". 
See SS2 and SS3 in Character Sets and Selection. 

Origin Mode (DEC Private) - DECOM 

Lines and columns are numbered consecutively, with the origin 
being line 1, column 1. The cursor is moved to the new home 
position when this mode is set or reset. 
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Set: ESC[?6h 



Reset: ESC[?61 
DECSCNM-SCREEN 






REVERSE ESC [?5h 
(BLACK-ON-WHITE) 

NORMAL ESC [?51 
(WHITE-ON-BLACK) 



The set state causes the 
be at the upper-left char 
position within the margi 
scrolling region (see Scr 
This is the Home position 
Origin Mode is set. Line 
are relative to the curre 
settings. For example, i 
margin is line 5, the top 
addressed as line 1 for c 
positioning. (Home posit 
therefore line 5, column 
absolute.) The cursor is 
to be positioned outside 
margins. 



origin to 
acter 
ns of the 
oil ing) . 

when 

numbers 
nt margin 
f the top 

line is 
ursor 
ion is 
1, 

not allowed 
the 



The reset state causes the origin to 
be at the upper-left character 
position on the screen. This is the 
Home position when Origin Mode is 
reset. Line numbers are not 
affected by the current margin 
settings. The cursor may be 
positioned outside the margins with 
a Cursor Position or Horizontal and 
Vertical Position control sequence. 



Screen Mode (DEC Private) - DECSCNM 
Set: ESC[?5h 



Reset: ESC[?51 



The set state causes the screen to 
be white with black characters. 



The reset state causes the screen to 
be black with white characters. 



Scrolling Mode (DEC Private) - DECSCLM 
Set: ESC[?4h 



Reset: ESC[?41 



The set state causes smooth 
scrolling at a maximum rate of six 
lines per second. 



The reset state causes jump 
scrolling . 
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2 CHARACTER SETS AND SELECTION 

Select Character Sets - SCS 

The VT125 text mode can display 94 characters (one character set) 
at a time without using control functions. But by using control 
functions to select the character sets, the VT125 can display more 
than 94 different characters on the screen by storing characters 
in up to five different character sets (some characters appear in 
more than one character set). The VT125 character sets are: 

United States character set 

United Kingdom character set 

Special characters and line drawing character set 

Alternate ROM standard character set 

Alternate ROM Special characters 

Alternate ROM is an optional feature of the VT100 



terminal controll< 


Br 


board that 


allows two 


mor e 


character 


sets 


to 


be 


r es i d( 


5n t in 


th 


e terminal 


, as 


comp 


a r ed 


with the 


graph 


ics 


pro( 


:essor 
VT100 


character 


sets which 


must 


be 


loaded 


for use . 


Refer 


to 


the 


Series 


Technical Manual 


for 


th 


e specifications of this 



ROM. 



character 
d Delete 



Tables 4-9 through 4-11 show the three standard VT125 c 
sets. Notice that the control characters and the Space an 
characters are the same in all character sets. 

Any two of the VT125 character sets can be considered active at 
any one time. They can be invoked (selected) with single-character 
control functions if they are first designated by multiple 
character escape sequences. The two active character sets are 
designated by the computer as G0 and Gl using the Select Character 
Set (SCS) escape sequence. Once the character sets are designated 
by the computer, a single control character is used to switch 
between the character sets. The Shift In (SI, octal 017) control 
character invokes the G0 character set. The Shift Out (SO, 016) 
control character invokes the Gl character set. 

The designated character sets are active until another Select 
Character Set (SCS) sequence is received. The G0 and Gl character 
sets can be redesignated by the computer as often as needed using 
the SCS sequence. The following sequences designate the VT125 G0 
character set: 

Name Mnemonic Sequence 

Select SCS ESC ( A Designate the United Kingdom 

Character character set as G0 

Set 

Select SCS ESC ( B Designate the United States 

Character character set as G0 

Set 
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Table 4-9 U.K. Character Set 



B7 
B 


6 

85 

s 











1 




1 





1 
1 


1 




1 

1 


1 
1 




1 

1 
1 




BIT, 


COLUMN 




1 


2 


3 


4 


5 


6 


7 




B4 B3 B2 Bl 


ROW 










NUL 









20 
16 
10 


SP 


40 
32 
20 





60 
48 
30 


@ 


100 
64 
40 


P 


120 
80 
50 


\ 


140 
96 
60 


P 


160 
112 
70 




1 


1 




1 
1 
1 


DC1 

(XON) 


21 

17 
11 


! 


41 
33 
21 


1 


61 
49 
31 


A 


101 
65 

41 


Q 


121 
81 

51 


a 


141 
97 
61 


q 


161 
113 
71 




10 


2 




2 
2 
2 




22 
18 
12 


II 


42 
34 
22 


2 


62 
50 
32 


B 


102 
66 
42 


R 


122 
82 
62 


b 


142 
98 
62 


r 


162 

114 
72 




11 


3 




3 
3 
3 


DC3 

(XOFF) 


23 
19 
13 


£ 


43 
35 
23 


3 


63 
51 
33 


C 


103 
67 
43 


S 


123 
83 
53 


c 


143 
99 
63 


s 


163 
115 
73 




10 


4 




4 
4 
4 




24 
20 
14 


$ 


44 
36 
24 


4 


64 
52 
34 


D 


104 
68 
44 


T 


124 
84 

54 


d 


144 
100 
64 


t 


164 
116 
74 




10 1 


5 


ENQ 


5 
5 
5 




25 

21 
15 


% 


46 
37 
25 


5 


66 
53 
35 


E 


105 
69 
45 


U 


125 
85 
55 


e 


145 
101 
65 


u 


165 
117 
75 




110 


6 




6 
6 
6 




26 
22 

16 


& 


46 
38 
26 


6 


66 
54 
36 


F 


106 
70 
46 


V 


126 
86 
56 


f 


146 
102 
66 


V 


166 

118 

76 




111 


7 


BEL 


7 
7 
7 




27 
23 
17 


/ 


47 
39 
27 


7 


67 
56 
37 


G 


107 
71 
47 


w 


127 
87 
57 


g 


147 
103 
67 


w 


167 

119 

77 




10 


8 


BS 


10 
8 
8 


CAN 


30 
24 

18 


( 


50 

40 
28 


8 


70 
56 
38 


H 


110 
72 
48 


X 


130 
88 
58 


h 


150 
104 
68 


X 


170 
120 
78 




10 1 


9 


HT 


11 
9 
9 




31 
25 
19 


) 


51 
41 
29 


9 


71 
57 
39 


I 


111 
73 
49 


Y 


131 
89 
59 


i 


151 
105 
69 


y 


171 
121 
79 




10 10 


10 


LF 


12 
10 
A 


SUB 


32 
26 

lA 


* 


52 
42 
2A 


■ 


72 
58 
3A 


J 


112 
74 
4A 


z 


132 
90 
5A 


i 


152 
106 
6A 


z 


172 
122 
7A 




10 11 


11 


VT 


13 

11 
B 


ESC 


33 
27 

IB 


+ 


53 
43 
2B 


1 


73 
59 
38 


K 


113 
75 
4B 


[ 


133 
91 
68 


k 


153 
107 
6B 


{ 


173 
123 
78 




110 


12 


FF 


14 
12 
C 




34 
28 
1C 


1 


54 
44 
2C 


< 


74 
60 
3C 


L 


114 
76 
4C 


\ 


134 
92 
5C 


1 


154 
108 
6C 


1 


174 
124 
7C 




110 1 


13 


CR 


15 
13 
D 




35 
29 

ID 


- 


55 
45 
2D 


= 


75 

61 
3D 


M 


116 
77 
4D 


] 


136 
93 
5D 


m 


155 
109 
6D 


> 


175 
125 
7D 




1110 


14 


SO 


16 

14 
E 




36 
30 

IE 


■ 


56 
46 
2E 


> 


76 
62 
3E 


N 


116 
78 
4E 


A 


136 
94 
5E 


n 


156 
110 
6E 


-s» 


176 
126 
7E 




1111 


15 


SI 


17 
15 
F 




37 

31 
IF 


/ 


57 
47 
2F 


? 


77 
63 
3F 





117 
79 
4F 


— 


137 
95 
5F 


o 


157 

111 
6F 


DEL 


177 
127 
7F 





KEY 



ASCII CHARACTER 



ESC 



33 


OCTAL 


27 


DECIMAL 


IB 


HEX 
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Table 4-10 U.S. Character Set 



B7 
B6 


B5 









1 



1 




1 
1 


1 




1 

1 


1 
1 




1 

1 
1 


BITS 


COLUMN 




1 


2 


3 


4 


5 


6 


7 


B4 B3 B2 Bl 


ROW 








NUL 









20 
16 
10 


SP 


40 
32 
20 





60 
48 
30 


@ 


100 

64 
40 


P 


120 
80 
50 


N 


140 
96 
60 


P 


160 

112 

70 


1 


1 




1 
1 
1 


DC1 

(XON) 


21 
17 
11 


! 


41 
33 
21 


1 


61 
49 

31 


A 


101 
65 
41 


Q 


121 
81 
51 


a 


141 
97 

61 


q 


161 
113 
71 


10 


2 




2 
2 
2 




22 

18 
12 


" 


42 
34 
22 


2 


62 
50 
32 


B 


102 
66 
42 


R 


122 
82 

52 


b 


142 
98 
62 


r 


162 
114 
72 


11 


3 




3 
3 
3 


DC3 

(XOFF) 


23 
19 
13 


# 


43 
35 
23 


3 


63 
51 
33 


C 


103 
67 
43 


S 


123 
83 
53 


c 


143 
99 
63 


s 


163 

115 
73 


10 


4 




4 
4 
4 




24 
20 
14 


$ 


44 
36 

24 


4 


64 
52 

34 


D 


104 
68 
44 


T 


124 
84 

54 


d 


144 
100 
64 


t 


164 
116 
74 


10 1 


5 


ENQ 


5 
6 
5 




25 
21 
16 


% 


46 
37 
25 


5 


65 
53 
35 


E 


105 
69 
46 


U 


125 
85 
56 


e 


145 
101 
65 


u 


155 
117 
75 


110 


6 




6 
6 
6 




26 
22 

16 


& 


46 
38 
26 


6 


66 
54 
36 


F 


106 
70 
46 


V 


126 
86 
56 


f 


146 
102 
66 


V 


166 

118 

76 


111 


7 


BEL 


7 
7 
7 




27 

23 

17 


/ 


47 
39 
27 


7 


67 
55 
37 


G 


107 
71 
47 


w 


127 
87 
57 


g 


147 
103 
67 


w 


167 

119 
77 


10 


8 


BS 


10 
8 
8 


CAN 


30 
24 
18 


( 


50 
40 
28 


8 


70 
56 
38 


H 


110 
72 
48 


X 


130 
88 
58 


h 


160 
104 
68 


X 


170 
120 
78 


10 1 


9 


HT 


11 
9 
9 




31 
25 
19 


) 


61 
41 
29 


9 


71 
57 
39 


I 


111 
73 
49 


Y 


131 
89 
59 


' 


151 
105 
69 


y 


171 
121 
79 


10 10 


10 


LF 


12 
10 
A 


SUB 


32 
26 

lA 


* 


52 
42 
2A 


• 


72 
68 
3A 


J 


112 
74 
4A 


z 


132 
90 

5A 


j 


152 
106 
6A 


z 


172 
122 
7A 


10 11 


11 


VT 


13 
11 
B 


ESC 


33 
27 
IB 


+ 


53 
43 
2B 


1 


73 
59 
3B 


K 


113 
75 
4B 


[ 


133 
91 
5B 


k 


153 
107 
6B 


< 


173 
123 
7B 


110 


12 


FF 


14 
12 
C 




34 
28 
IC 


9 


54 
44 
2C 


< 


74 
60 
3C 


L 


114 
76 
4C 


\ 


134 
92 
5C 


1 


154 
108 
6C 


1 


174 
124 
7C 


110 1 


13 


CR 


15 
13 

D 




36 
29 

ID 


- 


5S 
45 
2D 


= 


75 
61 
3D 


M 


115 
77 
4D 


] 


135 
93 
5D 


m 


155 

109 
60 


> 


175 
125 
7D 


1110 


14 


SO 


16 
14 
E 




36 
30 
IE 


■ 


56 

46 
2E 


> 


76 
62 
3E 


N 


116 
78 

4E 


A 


136 
94 

5E 


n 


156 

110 
6E 


-w 


176 
126 
7E 


1111 


15 


SI 


17 
15 
F 




37 
31 
IF 


/ 


57 
47 

2F 


? 


77 
63 
3F 





117 
79 
4F 


— 


137 
95 
5F 


o 


157 
111 
6F 


DEL 


177 
127 
7F 



KEY 



ASCII CHARACTER 



ESC 



33 


OCTAL 


27 


DECIMAL 


IB 


HEX 
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Table 4-11 Special Character and Line Drawing Character Set 



B7 
B 


3 
85 

> 









1 



1 




1 
1 


1 




1 


1 


1 
1 




1 

1 
1 


BITS 


COLUMN 




1 


2 


3 


4 


5 


6 


7 


B4 B3 82 81 


ROW 








NUL 









20 
16 
10 


SP 


40 
32 
20 





60 
48 
30 


@ 


100 
64 
40 


P 


120 
SO 
50 


♦ 


140 
96 
60 


SCAN 3 


160 

112 
70 


1 


1 




1 
1 
1 


DC1 

(XON) 


21 
17 
11 


I 


41 
33 
21 


1 


61 
49 
31 


A 


101 
65 
41 


Q 


121 
81 

51 


i 


141 
97 
61 


SCAN 5 


161 
113 
71 


10 


2 




2 
2 
2 




22 

18 
12 


II 


42 
34 
22 


2 


62 
50 
32 


B 


102 
66 
42 


R 


122 
82 
52 




142 
98 
62 


SCAN 7 


162 

114 
72 


11 


3 




3 
3 
3 


DC3 

(XOFF) 


23 

19 
13 


# 


43 
35 
23 


3 


63 
61 
33 


C 


103 
67 

43 


S 


123 
83 
53 




143 
99 
63 


SCAN 9 


163 
115 
73 


10 


4 




4 
4 
4 




24 
20 
14 


s 


44 
36 
24 


4 


64 
52 

34 


D 


104 

68 
44 


T 


124 
84 
54 




144 
100 

64 


- 


164 
116 
74 


10 1 


5 


ENQ 


5 
5 
5 




25 

21 
15 


% 


45 
37 
25 


5 


65 
53 
35 


E 


105 
69 
45 


U 


125 
85 
55 




145 
101 
65 


■ 


166 
11/ 
75 


Olio 


6 




6 
6 
6 




26 
22 

16 


& 


46 
38 
26 


6 


66 
64 
36 


F 


106 
70 
46 


V 


126 
86 
56 




146 
102 
66 


1 


166 

118 

76 


111 


7 


BEL 


7 
7 
7 




27 
23 
17 


1 


47 
39 
27 


7 


67 
55 
37 


G 


107 
71 
47 


w 


127 
87 
57 




147 
103 
67 


r 


167 

119 

77 


10 


8 


BS 


10 
8 

a 


CAN 


30 
24 

18 


( 


50 
40 
28 


8 


70 
56 
38 


H 


110 
72 
48 


X 


130 
.38 
58 




150 
104 
68 




170 
120 
78 


10 1 


9 


HT 


11 

9 
9 




31 
25 
19 


) 


51 
41 
29 


9 


71 
57 
39 


I 


1 11 
73 
49 


Y 


131 
89 
59 




151 
106 
69 


i 


171 
121 
79 


10 10 


10 


LF 


12 
10 
A 


SUB 


32 
26 

lA 


* 


52 
42 
2A 




72 
58 
3A 


J 


112 
74 
4A 


z 


132 
90 

5A 




152 
106 
6A 


ii 


172 
122 
7A 


10 11 


11 


VT 


13 
11 

B 


ESC 


33 
27 

IB 


+ 


53 
43 
28 


) 


73 
59 
3B 


K 


113 
75 
4B 


[ 


133 
91 
5B 




153 
107 
6B 


1! 


173 
123 
7B 


110 


12 


FF 


14 
12 
C 




34 
28 
1C 


) 


54 
44 
2C 


< 


74 
60 
3C 


L 


114 
76 
4C 


\ 


134 
92 
5C 




154 
108 
6C 


i^ 


174 
124 
70 


110 1 


13 


OR 


15 
13 
D 




35 

29 

ID 


- 


55 

45 
2D 


= 


75 
61 
3D 


M 


115 

77 
4D 


] 


135 
93 
5D 




155 
109 
6D 


i 


176 
125 
7D 


1110 


14 


SO 


16 

14 
E 




36 
30 
IE 


• 


56 
46 
2E 


> 


76 
62 
3E 


N 


lie 

78 

4E 


A 


136 
94 

5E 


■- 


156 
110 
6E 




176 
126 
7E 


1111 


15 


SI 


17 
15 
F 




37 
31 

IF 


/ 


57 
47 
2F 


? 


77 
63 
3F 





117 
79 

4F 


(BLANK! 


137 
96 
5F 


SCAN 1 


157 
111 
6F 


DEL 


177 
127 
7F 



KEY 



ASCII CHARACTER 



ESC 



33 


OCTAL 


27 


DECIMAL 


IB 


HEX 
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Name Mnemonic Sequence 

Select SCS ESC ( Designate the special character 

Character and line drawing character set 

Set as G0 

Select SCS ESC ( 1 Designate the Alternate ROM 

Character standard character set as G0 
Set 

Select SCS ESC ( 2 Designate the Alternate ROM 

Character special character and line 

Set drawing set as G0 

The following sequences designate the VT125 Gl character set: 

Name Mnemonic Sequence 

Select SCS ESC ) A Designate the United Kingdom 

Character character set as Gl 

Set 

Select SCS ESC ) B Designate the United States 

Character character set as Gl 

Set 

Select SCS ESC ) Designate the special character 

Character and line drawing character set 

Set as Gl 

Select SCS ESC ) 1 Designate the Alternate ROM 

Character standard character set as Gl 
Set 

Select SCS ESC ) 2 Designate the Alternate ROM 

Character special character and line 

Set drawing set as Gl 

The VT125 terminal also has a G2 and G3 character set. However, 
these character sets are always the United States (ASCII) 

character set. The G2 and G3 character sets can be selected for 
only one character at a time. The G2 and G3 character sets are 
selected using the single shift 2 (SS2) and single shift 3 (SS3) 
sequences. The terminal returns to the previously used character 

set after a single character is displayed. Select the G2 and G3 

character sets for one character using the following sequences. 

Name Mnemonic Sequence Function 

Single SS2 ESC N Selects the G2 (ASCII) 

Shift 2 033 115 character set for one 

character . 

Single SS3 ESC Selects the G3 (ASCII) 

Shift 3 033 117 character set for one 



character . 
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The United States and United Kingdom sets conform to the "ISO 
international register of character sets to be used with escape 
sequences". The other sets are private character sets. Special 
graphics means that the graphic characters for the codes 137(8) to 
176(8) are replaced with other characters. The specified character 
set will be invoked by SI or SO until another SCS is received. 
Table 4-9 lists the U.S. character set, Table 4-10 lists the U.K. 
character set, and Table 4-11 lists the special character and line 
drawing character set. The VT125's U.S. character set is a subset 
of the ASCII character set because in the VT125, only a few of the 
ASCII control characters have displayable forms. 

NOTE:^ The character set selected by SCS is only used by the text 
terminal. The graphics processor selects character sets with a 
ReGIS command. ~ "" 

Select Graphic Rendition - SGR 

Format: ESC [ Pn m default value: 

In the VT125, this turns on the character attributes, which are 
special display features that can be used (along with line 
attributes like double width) to make text on the screen appear 
special. All characters transmitted to the VT125 after the SGR 
sequence are displayed with the selected attributes until the next 
SGR sequence clears or changes the attributes. 

Name Mnemonic Sequence Meaning 

Select SGR ESC [ m Attributes off 

Graphic 

Rendition 

Select SGR ESC [ 1 m Bold or increased intensity 
Graphic 



Rendition 






SGR 

OFF ESC [0m 



Select SGR ESC [ 4 m Underline 

Graphic 

Rendition | *| UNDERSCORE ESC[4 m 

Select SGR ESC [ 5 m Blink IdEPENDS ON CURSOR 

Graphic 

Rendition t\ REVERSE ESC[7 m 

(BLACK-ON-WHITE) 

Select SGR ESC [ 7 m Negative (reverse) image 

Graphic 

Rendition 

All other parameter values are ignored. 

Without the Advanced Video Option, a character can have only one 
attribute, and the attribute can only be underline or reverse. 
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Either 4 or 7 can be used in the control sequence, but the VT125 
interprets the parameter as whichever attribute has been selected 
for the cursor in SET-UP. (See cursor selection in the SET-UP 
chapter. ) 

3 SCROLLING 

Scrolling Region 

The scrolling region is the area of the screen that can receive 
new characters by scrolling old characters off the screen either 
up or down. This area is defined by the top and bottom screen 
margins. The minimum size of the scrolling region allowed is two 
lines, so the number of the top margin must be at least 2 less 
than the number of the bottom margin. The cursor moves to the home 
position when the margins are set (see Origin Mode in Modes) . 

Set Top and Bottom Margins (DEC Private) — DECSTBM 



Format: ESC [ Pt; Pb r 



default values: Full Screen 

This sequence sets the top and 
bottom margins to define the 
scrolling region. Parameter Pt is 
the line number of the top line in 
the scrolling region; parameter Pb 
is the line number of the bottom 
line in the scrolling region. 
Default is the complete screen (no 
margins) . 

NOTE; Power up or reset causes the scrolling region to be the 
complete screen. 

4 CURSOR POSITIONING 

The cursor indicates the location of the active position. This is 
where the next character appears. The cursor always moves one 
column to the right when a character appears, and moves down one 
line when the terminal receives a line feed. The cursor moves to 
the left margin when the terminal receives a carriage return. If a 
command tries to move the cursor past any margin, the action that 
will result is stated. The cursor moves to the home position (see 
Origin mode) when the top and bottom margins of the scrolling 
region are set and when Origin mode is set or reset. Table 4-12 
lists the sequences that move the cursor according to their 
parameters : 

5 TABS 

Tabs are positions selected on the horizontal lines of the screen. 
The cursor advances (tabs) to the tab stops when the terminal 
receives an HT (octal 011) control character. Each control 
character advances the cursor to the next tab stop. If no tabs 
are set, any HT character moves the cursor to the right margin. 



4-21 



DECSTBM 

TOP MARGII\ OF SCROLLING REGIOM 



ESC[Pt; Pb r (INCLUDES BOTTOM MARGIN) 



BOTTOM MARGIN OF SCROLQNG REGION 
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Table 4-12 Cursor Positioning Commands 



Command Name 

Format 



Default 
Value 



Mnemonic 
Function 



Cursor Up 

ESC [ Pn A 1 



Cursor Down 

ESC [ Pn B 1 



Cursor Forward 

ESC [ Pn C 



Cursor Backward 

ESC [ Pn D 



Cursor Position 

ESC [ Pi ; PC H 1 



CUU 

Moves the cursor Pn lines up 
in same column. Cursor stops 
at the top margin. 

CUD 

Moves the cursor down Pn 
lines in same column. Cursor 
stops at the bottom margin. 

CUF 

Moves the cursor Pn columns 
to the right. Cursor stops at 
the right margin. 

CUB 

Moves the cursor Pn columns 
to the left. Cursor stops at 
the left margin. 

CUP 

Moves the cursor to line Pi, 
column Pc. Default value for 
either moves the cursor to 
the first line or column, 
respectively; for both, to 
home. For Pi or Pc outside 
margins, cursor stops at 
nearest margin. 

The numbering of lines 
depends on Origin Mode. In 
the VT125, this control acts 
like the Horizontal and 
Vertical Position control. 



Horizontal and Vertical 
Position 

ESC [ PI ; PC f 



HVP 

Moves the cursor to line Pi, 
column Pc. Default value for 
either moves the cursor to 
the first line or column, 
respectively. When the 
default value is used for 
both parameters, the cursor 
moves to home position. For 
Pi or Pc outside margins, 
cursor stops at nearest 
margin. 
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Table 4-12 Cursor Positioning Commands 



Command Name 

Format 



Default 
Value 



Mnemonic 
Function 



Cursor Position Report 
ECS [ PI ; PC R 



Index 



ESC D 



Reverse Index 
ESC M 



Next Line 

ESC E 



Save Cursor (DEC Private) 
ESC 7 



Restore Cursor (DEC Private) 
ESC 8 



The numbering of lines 
depends on Origin Mode. In 
the VT125, this control 
behaves identically with 
Cursor Position. 

CPR 

Requested by DSR ESC [ 6 n. 

See the Reports section. 

IND 

None Moves the cursor down 

one line in same column. If 

the cursor is at the bottom 

margin, a scroll up is 

performed. 

RI 

None Moves the cursor to the 
same horizontal position on 
the preceding line. If the 
cursor is at the top margin, 
a scroll down is performed. 

NEL 

None Moves cursor to the 
first position on the next 
line down. If the cursor is 
at the bottom margin, a 
scroll up is performed. 

DECSC 

None 

Saves the cursor position, 

graphic rendition (character 

attribute) , and character set 

in terminal memory. (See 

Restore Cursor) . 

DECRC 
None 

Restores the previously saved 
cursor position, graphic 
rendition (character 
attribute) , and character 
set. If none was saved the 
cursor moves to the top left 
home position (line 1, column 
1) regardless of Origin Mode. 
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Horizontal Tabulation Set - HTS 
Sequence 

ESC H 

Tabulation Clear - TBC 
Sequence 

ESC [ g 

ESC [ 3 g 



Meaning 

Set one horizontal stop at the 
cursor position. 



Meaning 

Clear the horizontal tab stop at 
the active position (default) . 

Clear all horizontal tab stops. 



6 LINE ATTRIBUTES 

Line attributes are special display features of the VT125 that 
affect a complete line at a time. Only the line containing the 
cursor is affected. The cursor stays in the same character 
position unless it would be to the right of the right margin, in 
which case it moves to the right margin. 

Double Height Line (DEC Private) - DECDHL 



Sequence 

Top Half: ESC #3 
Bottom Half: ESC #4 



DECDHL 



AB 



TOP HALF ESC #3 
BOTTOM HALF ESC #4 



DECDWL AB ESC #6 
DECSWL AB ESC #5 



Meaning 



These sequences cause the line 
including the active position 
to become the top or bottom 
half of a double-height 
double-width line. The 
sequences must be used in pairs 
on adjacent lines and the same 
character output must be sent 
to both lines to form full 
double-height characters. If 
the line was single-width 
single-height, all characters 
to the right of the center of 
the screen are lost. 



Double-Width Line (DEC Private) - DECDWL 
Sequence Meaning 

ESC #6 



This causes the line that 
includes the active position to 
become double-width 
single-height. If the line was 
single-width Single-height, all 
characters to the right of the 
center of the screen are lost. 
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HOME (DECOM ESC[?61) 
CUP ESC[H 
HVPESC[f 



MEMORY 



DECRC \ 
ESC 8 \ 



T" DECSC 
I ESC 7 




COMPUTER 



HOME 

(DECOM ESCl?6h| 

CUPESC[H 

HVPESC[f 



/ 



\ CUU ESC[PnA ' 
RI ESC M / 

/ 
/ 

y 

CUF 
ESCtPnC 



CPR (SEE DECOM) 

ESC[P1, Pc R 

(INVOKED BY DSR ESC[6n) 
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single-width Line (DEC Private) - DECSWL 

Sequence Meaning 

ESC #5 This causes the line that 

includes the active position to 
become single-width 
single-height. This is the 
default condition for all new 
lines on the screen. 
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7 ERASING 

Erasing removes characters from the text memory of the VT125. When 
characters are erased from the text memory, they are lost. Any 
complete line erased by Erase in Display has its line attribute 
set to single-height, single-width. Erasing does not change the 
number of columns per line. 



Erase In Display — ED 

ESC [ Pn J 



ESC [ J 
ESC [ J 
ESC [ 1 J 
ESC [ 2 J 



Erase In Line - EL 
ESC [ Pn K 



ESC [ K 

ESC [ K 

ESC [ 1 K 

ESC [ 2 K 



default value: 

This sequence erases some or 
all of the characters in the 
display according to the 
parameter. Any complete line 
erased by this sequence is 
given a line attribute for 
single-height, single-width. 

Erase from the cursor to the 
end of the screen 

Erase from the cursor to the 
end of the screen 

Erase from start of the screen 
to the cursor 

Erase all of the display — all 
lines are erased, changed to 
single-width, and the cursor 
does not move. 



default value: 

Erases some or all characters 
in the active line according to 
the parameter. Erasing does not 
change line attributes. 

Erase from the cursor to the 
end of the line 

Erase from the cursor to the 
end of the line 

Erase from the start of the 
line to the cursor 

Erase all of the line 



4-28 



r 



ED 

Esqij 



EL 
"ESC[1K" 



EL 
■ESC[0K- 



E RASE IN LINE 

EL 

ESC[2K 



ERASE IN 
DISPLAY 
ED 
ESC[2J 



ED 
ESC[0J 
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8 VT125 COMMUNICATION AND GRAPHICS PROTOCOL CONTROLS 

The VT125 uses an ANSI protocol called the Device Control String 
to control its graphics and some of its communications. A control 
string_ is a group of characters that have a clearly marked 
beginning and end and are understood by a device as a unit for 
control purposes. The Device Control String is made of an 
introducer followed by data followed by a terminator. The 
introducer is two characters (ESC P) that tell the VT125 to 
understand the characters that follow as parameter information 
about which graphics protocol is coming (ReGIS, DECwriter, or 
VT105) and where it should go (to the host, the auxiliary port, or 
the video screen) . The rest of the string is graphics data in the 
specified protocol, followed by the terminator. The terminator is 
two characters (ESC ) called the String Terminator, and it returns 
the VT125 to its text operation. When a device control string 
begins, the VT125 can not understand another device control string 
command until the first one is terminated by the String Terminator 
characters. 

Device Control String (Introducer) - DCS 



ESC P 



Device Control String Parameters 
ESC P p or ESC P p 



ESC Pip 



Introducer to the commands that 
control the VT125's internal 
protocols. When the VT125 
receives this sequence from one 
of its data paths, it looks at 
that same data path for one or 
two more characters to select 
the operation, as listed below. 
(See Chapter 7 for an 
explanation of the data paths.) 



Enter ReGIS, accepting data 
from the same data path as this 
sequence, at the command level 
that was in effect at the end 
of the last ReGIS device 
control string. (ReGIS is at 
the highest command level if 
the terminal was reset after 
the last device control 
string . ) 



Enter ReGIS, accepting data 
from the same data path as this 
sequence, and force immediate 
synchronization to the highest 
command level in the same way 
that the ";" character acts in 
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ESC P 2 p 



ESC P 3 p 



ESC P Pn q - Delimit image format 



a ReGIS command string. (The 
semicolon is explained in the 
ReGIS chapter.) 

Enter ReGIS according to p 
(allowing completion of 
previous commands) and also 
send the ReGIS text to the data 
path that was previously 
selected. (This typically is 
the host to VT100 data path and 
allows the simultaneous display 
of both the graphics and the 
ReGIS text that creates the 
graphics. ) 

Enter ReGIS according to 1 p 
(immediate synchronization) and 
also send the ReGIS text to the 
data path that was previously 
selected. (This typically is 
the host to VT100 data path and 
allows the simultaneous display 
of both the graphics and the 
ReGIS text that creates the 
graphics. ) 

Accept the text that follows 
from the same data path as this 
sequence as DECwriter graphics 
hard copy descriptor and 
display it. Pn is ignored. 
Refer to the Media Copy control 
function description for 
information about generating 
DECwriter descriptor. 



ESC P Pn t - enter VT105 
emulator mode 



Accept the text that follows 
from the same data path as this 
sequence as VT105 commands to 
be executed by the VT125. The 
parameter is ignored and may be 
deleted (but if included, 
should be for compatibility 
with future sequences) . The 
VT105 emulator does not have 
the simultaneous text display 
capability of ReGIS. 
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string Terminator - ST 
ESC \ 



Media Copy - MC 
ESC [ PS i 



ANSI parameters: 
ESC [ 4 i 



ESC [ 5 i 



ESC [ 6 i 



ESC [ 7 i 



End the string of data and 
return the VT125 to text mode. 



Media Copy selects the 
connections between the 
different ports of the VT125. 
There are two classes of 
parameters (Ps) understood by 
this sequence: ANSI 
standardized and DEC private. 
Standardized and private 
parameters can not be in the 
same sequence. More than one 
parameter from a class can be 
in each sequence, using the 
semicolon syntax for multiple 
selective parameters 
(Ps;..;Ps). See the explanation 
of ports in the communication 
chapter for more information 
about selecting parameters. 



Turn off copying of data from 
the host computer to the 
auxiliary port. 



Turn on copying of data from 
the host computer to the 
auxiliary port. 



Turn off copying of data from 
the host computer to the text 
screen. 



Turn on copying of data from 
the host computer to the text 
screen. 
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Private parameters: 
ESC [ ? i 



Select the auxiliary port as 
the destination for DECwriter 
descriptor data containing the 
contents of the graphics memory 
as controlled by the S(H) 
option in ReGIS. Usually used 
to produce a hard copy of the 
screen on an LA34-VA. This is 
the default condition when 
using the ReGIS protocol. 



ESC [ ? 2 i 



Select the host computer as the 
destination for DECwriter 
descriptor data containing the 
contents of the graphics memory 
as controlled by the S(H) 
option in ReGIS. Usually used 
to store a file of DECwriter 
descriptor on the host 
computer, for later 
transmission to an LA34-VA or 
VT125. 

9 REPORTS 

Reports are transmitted by the VT125 in response to requests from 
the computer or other device. Reports are used to determine the 
cursor position, the type of terminal, and the operational status 
of the terminal. The following sequences are the requests for 
reports and the reports generated: 



Cursor Position Report 

ESC [ Pi ; PC R 



This report is requested by a 
Device Status Report (DSR) 
sequence (ESC [ 6 n) . The 
terminal reports the active 
position with the CPR sequence. 
This sequence has two parameter 
values, the first specifying 
the line and the second 
specifying the column. The 
default condition with no 
parameters present, or 
parameters of 0, indicates the 
cursor at home position. The 
numbering of lines depends on 
the setting of Origin Mode. 
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Device Attributes - DA 

ESC [ Pn c 

Request: 

ESC [ c or ESC [ c 



Response : 

ESC [ ? 12 ; <VT100 features> 
<VT125 features> ; <VT125 ROM 
version> c 



? 12 



<VT100 features> 



<VT125 features> 



<VT125 ROM version> 



default value: 



A device asks the VT125 to 
identify itself by sending the 
DA control sequence with either 
no parameter or a parameter of 
0. 



The VT125 responds to the DA 
request with a DA sequence 
having numeric parameters only 
on the same data path that the 
request came from. 



DEC private identifier for the 
VT125 



5 if no advanced video option 
is installed. 7 if an advanced 
video option is installed. The 
VT125 checks the VT100 with an 
internal DA swap during power 
up or reset. 



1 if a printer is connected to 
the auxiliary port. if 
nothing is connected to the 
auxiliary port. The VT125 
checks for a printer by reading 
the EIA DSR pin during power up 
or reset. Only printers that 
drive DTR can be detected. 



Number indicating the firmware 
revision level of the VT125 
graphics processor code. 
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Identify Terminal (DEC Private) - DECID 



Format: ESC Z 



This sequence causes the same 
response as Device Attributes 
if the terminal is in ANSI 
mode. (See VT52 Reports.) This 
sequence will not be supported 
in future DEC terminals; 
therefore, any new software 
should use Device Attributes. 



Device Status Report - DSR 

Format: ESC [ Ps n default value: 

Requests the general status of 
the VT125 with the following 
sequences: 

ESC [ 5 n Command from computer - report 

status (using a DSR control 
sequence) 

ESC [ 6 n Command from computer - report 

active position (using a Cursor 
Position Report control 
sequence) 

Reports the general status of the VT125 on the same data path that 
the request came on with the following sequences: 



ESC [ n 



ESC [ 3 n 



Response from VT125 - Ready, 
no malfunctions detected 
(default) 

Response from VT125 - 
Malfunction - soft error - 
reset and retry 

DSR with a parameter value of 
or 3 is always sent as a 
response to a requesting DSR 
with a parameter value of 5. 
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RESET 



Reset To Initial State - RIS 
ESC c 



Reset the VT125 to its initial 
state. This is the state it has 
after it powers up, performs 
the internal self-test, and 
reads the set-up information in 
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the user permanent SET-UP 
feature memory. 

NOTE; When the terminal is reset, Cursor Key mode and Origin mode 
are reset. Keypad Numeric mode is selected, and the top and bottom 
margins of the scrolling region are set to be the complete screen. 
Any graphics protocol selection a nd the g jf a P b i c s m e^m o£y _a££ 
cleared and the graphics processor returns to text mode. 

11 TESTS AND ADJUSTMENTS 

The VT125 has many tests which are performed to be sure the 
terminal is running properly. Also, a pattern for screen alignment 
is provided. All DECTST sequences have an effect on the 
communication port. See Table 7-1. See the Operator Maintenance 
chapter for the meanings of displayed error codes. 

Screen Alignment Display (DEC Private) - DECALN 

ESC #8 

This command fills the entire 

E E E E E screen area with uppercase E's 

£ £ E £ g for screen focus and alignment. 

DECALN This command is used by DEC 

E E E E E ESC #8 manufacturing and Field Service 

E E E E E personnel. 

Invoke Confidence Test - DECTST 

Sequences with a first parameter of 2 tell the VT125 to tell the 
VT100 to do its self-tests according to the numeric parameter. 
Table 4-13 lists the VT100 tests. Sequences with a first 
parameter of 4 tell the VT125 to do its own self-tests according 
to the selective parameters that follow the 4. Table 4-14 lists 
the VT125 tests. See the Operator Maintenance chapter for 
explanations of the tests' actions. 

NOTEj Be sur e that these sequences get transmitted correctly 

because some wrong sequences do not give any indication of error. 

12 INDICATORS 

Keyboard Indicators 

The keyboard has seven indicator lights that are light emitting 
diodes (LEDs) . The ON LINE and LOCAL indicators light to indicate 
the communication status of the terminal. If the keyboard is 
connected and power is on, either the ON LINE or the LOCAL 
indicator is on. 

The KBD LOCKED indicator lights to show the keyboard locked 
condition. In this condition the keyboard transmit buffer is full 
and can not accept characters from the keyboard. 
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Table 4-13 VT100 Self-tests 



VT100 Self-test Format: ESC [ 2 ; Pn y 
Sequence Meaning 



ESC [ 2 ; 1 y VT100 resets and performs power up test. 

Also causes VT125 power up self-test. 

ESC [ 2 ; 2 y VT100 Data Loop Back test. Must use test 

connector. Not usable while graphics 
processor is installed. 

ESC [ 2 ; 3 y VT100 power up and data loop back tests. 

Must use test connector. Not usable while 
graphics processor is installed. 

ESC [ 2 ; 4 y VT100 EIA modem control loopback test. Must 

use test connector. Not usable while 
graphics processor is installed. 

ESC [ 2 ; 5 y VT100 power up and EIA modem control loopback 

tests. Must use test connector. Not usable 
while graphics processor is installed. 

ESC [ 2 ; 6 y VT100 data loop back and EIA modem control 

loopback tests. Must use test connector. 
Not usable while graphics processor is 
installed. 

ESC [ 2 ; 7 y VT100 power up, data loop back and EIA modem 

control loopback tests. Must use test 
connector. Not usable while graphics 
processor is installed. 

ESC [ 2 ; 9 y Repeat VT100 power up test continuously until 

failure or power off. Not usable while 
graphics processor is installed. 

ESC [ 2 ; 10 y Repeat VT100 data loopback test continuously 

until failure or power off. Must use test 
connector. Not usable while graphics 
processor is installed. 

ESC [ 2 ; 11 y Repeat VT100 powerup and data loopback tests 

continuously until failure or power off. 
Must use test connector. Not usable while 
graphics processor is installed. 

ESC [ 2 ; 12 y Repeat VT100 EIA modem control loopback test 

continuously until failure or power off. 
Must use test connector. Not usable while 
graphics processor is installed. 
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Table 4-13 VTlOO Self-Tests (Cont) 



VTIOO Self-Test Format: ESC [ 2 ; Pn y 
Sequence Meaning 

ESC [ 2 ; 13 y Repeat VTlOO power up and EIA modem control 

loopback tests continuously until failure or 
power off. Must use test connector. Not usable 
while graphics processor is installed. 

ESC [ 2 ; 14 y Repeat VT100 data loop back and EIA modem 

control loopback tests continuously until 
failure or power off. Must use test 
connector. Not usable while graphics 
processor is installed. 

ESC [ 2 ; 15 y Repeat VT100 power up, data loop back and EIA 

modem control loopback tests continuously 
until failure or power off. Must use test 
connector. Not usable while graphics 
processor is installed. 



Table 4-14 VT125 Self-Tests 



VT125 Self-test Format: ESC [ 4 ; 1 ; Ps . . . ; Ps y 

Test parameters may appear in the sequence in any order but they 
always run in increasing numerical order. Always include the power 
up test parameter for correct display of error indications. 

Ps = 1 VT125 Power up test 

Ps = 2 VT125 Host port data loopback test 

Ps = 3 VT125 Printer port data loopback test 

Ps = 4 VT125 Color test 

Ps = 5 VT100 Power up test (also causes VT125 Power 

up test) 

Ps = 9 Repeat any selected tests continuously until 

power off or failure 

See the Operator Maintenance chapter for the meanings of displayed 
error codes. 
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The LI through L4 indicators are programmable and can be assigned 
any meaning for specific applications. The following sequences 
turn these indicators on or off: 



Load LEDs (DEC Private) - DECLL 
ESC [ Ps;Ps Ps q 



default value: 
Load the four programmable 
indicators on the keyboard 
according to the parameter (s) . 







Sequence 


ESC 







q 


ESC 




1 


q 


ESC 




2 


q 


ESC 




3 


q 


ESC 




4 


q 



Meaning 

Clear indicators #1 through 4 

Light indicator #1 

Light indicator #2 

Light indicator #3 

Light indicator #4 

Indicator numbers are indicated on the keyboard. 

VT52 COMPATIBLE SEQUENCES 

The VT125 VT52 compatible sequences meet private DIGITAL 
standards. Therefore, the VT125 can use existing software designed 
for previous terminals such as the VT52, only for text 
applications. The graphics processor cannot operate with VT52 
compatible sequences. VT52 compatibility is selected from the 
keyboard in SET-UP (refer to chapter 2) or by the computer using a 
sequence (refer to the ANSI compatible sequences section of this 
chapter) . 

SET-UP FEATURE AND MODE SELECTION 

While in VT52 mode, most of the SET-UP feature selections of the 
VT125 can not be selected using sequences. However, the following 
three modes can be selected using sequences: 

ANSI mode 

Alternate Keypad mode on 

Alternate Keypad mode off 
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VT52 MODES 



Enter ANSI Mode 
Format: ESC < 



All subsequent escape sequences 
are understood according to 
ANSI Standards X3. 64-1979 and 
X3. 41-1974. The VT52 escape 
sequences shown in this section 
are not recognized. 
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Table 4-15 VT52 Mode Auxiliary Keypad Codes 



Key 



Alternate 
Keypad 
Mode Off 



Alternate 
Keypad 
Mode On 



ESC 

1 1 ESC 

2 2 ESC 

3 3 ESC 

4 4 ESC 

5 5 ESC 

6 6 ESC 

7 7 ESC 

8 8 ESC 

9 9 ESC 
-(minus) -(minus) ESC 
, (comma) , (comma) ESC 
.(period) .(period) ESC 
ENTER Same as RETURN key ESC 
PFl ESC P ESC 
PF2 ESC Q ESC 
PF3 ESC R ESC 
PF4 ESC S ESC 



? 

• 

? 
7 

7 
7 
7 
7 
7 
7 
7 
7 

P 

Q 
R 
S 



P 

q 

r 

s 
t 
u 

V 

w 

X 

y 

m 
1 
n 
M 



Alternate Keypad Mode On 
Format: ESC = 



Alternate Keypad Mode Off 



Format: ESC > 



The auxiliary keypad keys will 
send unique identifiable escape 
sequences for use by 
applications programs. Table 
4-15 lists these codes and 
sequences . 



The auxiliary keypad keys send 
the ASCII codes for the 
functions or characters on the 
keys. 
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VT52 CHARACTER SETS AND SELECTION 



While in VT52 mode the VT125 can use either the character set 

selected in SET-UP B or the VT125 Special Character and Line 

Drawing character set. The following sequences select the 
character sets. 
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Enter Graphics Mode 
Format: ESC F 



Causes the special graphics 
character set to be used. 



NOTE: The special graphics characters in the VT125 are different 
from those m the VT52. See Table x-x in Appendix X. 

Exit Graphics Mode 



Format; 



ESC G 



This sequence causes the 
standard ASCII character set to 
be used. 

15 VT52 CURSOR POSITIONING 

The cursor indicates the location of the active position. This is 
where the next graphic character appears. The cursor always moves 
one column to the right when a graphic character is displayed, and 
moves down one line when a line feed is received. The cursor 
moves to the left margin when a carriage return is received. If a 
command tries to move the cursor past any margin, the action that 
will result is stated. The VT52 mode margins are always the top 
and bottom of the display screen. Table 4-16 lists the sequences 
that move the cursor according to their parameters: 
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Table 4-16 



Special Character 
Mode Comparison 



and Line Drawing Set and Graphics 



Octal 


US/UK 




Special Character . 


and 


VT52 In 






Code 


Set 




Line Drawing Set 




Graphics Mode* 


137 






Blank 




Blank 






140 


\ 


<> 


Diamond 




Reserved 






141 


a 




Checkerboard 




Solid rectangle 








(error indicator) 




1 






142 


b 


ht 


Horizontal tab 








143 


c 


ff 


Form feed 








144 


d 


cr 


Carriage return 








145 


e 


If 


Line feed 








146 


f 


O 


Degree symbol 




Degrees 






147 


g 


+- 


Plus/minus 




Plus or minus 


150 


h 


nl 


New line 




Right arrow 




151 


i 


vt 


Vertical tab 




Elipsis (c 


lots) 


152 


J 


1 


Lower-right corner 




Divide by 






153 


k 


-| 


Upper-right corner 




Down arrow 




154 


1 


1 


Upper-left corner 




Bar at scan 





155 


m 


L 


Lower-left corner 




Bar at scan 


1 


156 


n 


+ 


Crossing lines 




Bar at scan 


2 


157 


o 




Horizontal line — 


scan 1 


Bar at scan 


3 


160 


P 




Horizontal line — 


scan 3 


Bar at scan 


4 


161 


q 




Horizontal line — 


scan 5 


Bar at scan 


5 


162 


r 




Horizontal line — 


scan 7 


Bar at scan 


6 


163 


s 




Horizontal line — 


scan 9 


Bar at scan 


7 


164 


t 


T- 


Left "T" 




Subscript 







165 


u 


-1 


Right "T" 




Subscript 


1 




166 


V 


1 


Bottom "T" 




Subscript 


2 




167 


w 


T 


Top "T" 




Subscript 


3 




170 


X 


1 


Vertical bar 




Subscript 


4 




171 


y 


< = 


Less than or equal 


to 


Subscript 


5 




172 


z 


= > 


Greater than or eqi 


ual to 


Subscript 


6 




173 


{ 


i-i 


Pi 




Subscript 


7 




174 


1 


/= 


Not equal to 




Subscript 


8 




175 


} 


L- 


UK pound sign 




Subscript 


9 




176 




• 


Centered dot 




Paragraph 







* Not available in VT125. 
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16 VT52 ERASING 

Erasing removes characters from the screen of the VT125. When 
characters are erased from the screen, the characters are lost. 
The following sequences erase characters from the screen: 

Erase to End of Screen 

Format: ESC J 

Erase all characters from the cursor 
to the end of the screen. The cursor 
does not move. 

Erase to End of Line 

Format: ESC K Erase all characters from the cursor 

to the end of the current line. The 
cursor does not move. 

17 VT52 REPORTS 

The VT125 generates only one report in VT52 mode: 

Identify 

Format: ESC Z This sequence causes the terminal to 

send its identifier escape sequence 
to the computer. 

The response is ESC / Z. 

NOTE: This is the VT52 response. 
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Table 4-17 VT52 Cursor Positioning 



Cursor Up 
Format: ESC A 

Cursor Down 
Format: ESC B 

Cursor Right 
Format: ESC C 

Cursor Left 
Format: ESC D 

Cursor to Home 
Format: ESC H 

Reverse Line Feed 
Format: ESC I 



Direct Cursor Address 
Format: ESC Y line column 



Move the cursor up one line in same 
column. Cursor stops at the top of 
the screen. 



Move the cursor down one line in 
same column. Cursor stops at the 
bottom of the screen. 



Move the cursor one column to the 
right. Cursor stops at the right 
margin. 



Move the cursor one column to the 
left. Cursor stops at the left 
margin. 



Move the cursor to the home position 
at line 1, column 1. 



Move the cursor up one line in the 
same column. If the cursor is at the 
top margin, a scroll down is 
performed. 



Move the cursor to the specified 
line and column. The line and column 
numbers are sent as the ASCII 
characters whose codes are the 
decimal numbers plus 31; for 
example, 32(10) (SPACE) refers to 
the first line or column, and 
111(10) refers to the eightieth 
column. 
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DECDHL 



AB 



TOP HALF ESC #3 
BOTTOM HALF ESC; 



DECDWL AB ESCff6 
DECSWL AB ESC #5 






SGR 
OFF ESCl0m 

BOLD ESC[1IV1 
UNDERSCORE ESC[4i 
BLINK ESCI5M 

REVERSE ESC17 m 
(BLACK ON-WHITE) 



DESIGNATION: G0 



Gl 



INVOKED BY: SI: CTRL/0 SO: CTRL/N 



U.K. 
U.S. 

GRAPHICS 
ALT ROM 



ESC(A 
ESC(B 
ESC(0 
ESCd 



ALT SPECIAL ESC(2 



ESOA 
ESCIB 
ESC)0 
ESCll 
ESC)2 



E E E E E 

E E E E E 

E E E E E 

E E E E E 



DECALN 
ESC #8 



DECSCNMSCREEN 

K REVERSE ESC [?5h 
T (BLACK-ON-WHITE) 



Q 



NORMAL ESC [?51 
(WHITE-ON-BLACK) 



DECANM 

ANSI mode (from VT52) ESC < 

VT52 mode (from ANSI) ESC(?21 

' DECARM 

autorepeat ESC[?B)i 

no autorepeat ESC1?81 

' DECAWM 

autowrap ESC[?7h 

no autowrap ESC[?71 



DECCKM-Cursor Keys 




application 


ESC[?1f. 


cursor control 


ESC[?n 


DECCOLM 




132 column 


ESC|?3h 


80 column 


ESCR31 


DECPAM 




keypad application 


ESC = 


DECPNM 




keypad numeric 


ESC> 


DECOM-Origin Mode 




relative 


ESC[?6h 


absolute 


ESC[?61 


DECSCLM 




smooth scroll 


ESC[?4h 


jump scroll 


ESC[?41 



Figure 4-1 VT125 ANSI Mode Display Control Functions 
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CHAPTER 5 
ReGIS GRAPHIC PROGRAMMING 



INTRODUCTION 

This chapter explains the Remote Graphic Instruction Set (ReGIS) , 
a graphic descriptor, as it is used in the VT125 graphics 
processor. With the information in this chapter, a programmer can 
prepare images for display on the VT125 internal monitor or a 
connected color monitor, or print the images on a DECwriter 
graphic printer. 

Definitions 

ReGIS is called a graphic descriptor. A graphic descriptor is a 
symbol system that describes the parts of an image. An image is a 
type of information that people understand by seeing it and 
thinking about it in relation to familiar visual images. An image 
(graphic) is the best way to communicate some types of 
information. The problem for a graphic descriptor is to describe 
the image with as few symbols as possible to save storage space 
and communication line time. ReGIS works by considering an image 
to be a group of graphic objects. Each graphic object is a 
standard geometric form that can be described with a few 
characters of information. For example, ReGIS understands that 
the form of a circle applies to any circle that can be drawn. A 
circle can be described on the screen by the location of its 
center and a point on its circumference. The same type of 
understanding for other graphic objects lets ReGIS describe 
graphic images with short commands. 

Each graphic object is made of a group of the smallest units of 
information on the screen. These units are pixels; their size is 
determined by both the minimum size of unit that the monitor can 
display, and by the maximum number of units that the graphics 
processor can address and store. If a device can display more 
pixels than another, it is has higher resolution than the other. 
The VT125 graphics processor can display 184,320 pixels in a 768 X 
240 array and is considered a medium resolution device. The 



graphics processor's memory can store 196,608 pixels in a 768 X 
256 X 2 array. The display of the VT125 is a window that looks 
into this memory. The window can move in any direction with 
Screen command to display all parts of the pixel memory, "" 
move an object in the image to the center of the display. 



a 

or to 
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Table 5-1 VT125 Graphics Protocols 



Protocol Example String 

ReGIS ESC P p ...data... ESC \ 

LA34-VA Hard Copy Descriptor ESC P q ...data ESC \ 

VT105 Emulation ESC P t ...data... ESC \ 



ReGIS SYNTAX 

Introduction 

The VT125 graphics processor command syntax is a Device Control 
String (DCS) introducer sequence (ESC P) , followed by protocol 
selection characters, followed by any number of characters in the 
selected protocol, followed by the String Terminator (ST) sequence 
(ESC \) . (These sequences are explained in detail in the Received 
Character Processing chapter of this book under VT125 
Communication and Graphic Protocol Controls.) The first characters 
after ESC P select the graphic protocol that is used during the 
rest of the string. These characters are formatted as part of a 
private ANSI control sequence. Table 5-1 lists the possible 
graphic protocols with typical device control strings. See the 
Received Character Processing chapter for complete details. 

The LA34-VA Hard Copy Descriptor protocol is explained in the 
Protocol Controls section that was mentioned above. The VT105 
Emulation Protocol is explained in the VT105 chapter of this book. 
The ReGIS protocol is explained here. 

ReGIS Single Character Commands 

Any commands from the complete ReGIS instruction set can follow 
the initial selection characters. A ReGIS command is a single 
alphabetic command key character followed by options in many 
formats including parentheses and brackets. ReGIS does not care 
whether an alphabetic character is uppercase or lowercase except 
in any quoted string. The key character is usually the first 
letter of the name of the command, for example "S" for screen. 
Any keyletter that is not included in this guide, and any 
characters in parentheses, quotes, or brackets, or any digit 
strings, that follow the invalid keyletter or a semicolon are 
ignored. 

Parentheses, Brackets, Pixel Vectors, and Quotes 

Parentheses "(" and ")" after a single character mean that the 
characters inside the parentheses are options to the command 
(example: S(E) = screen erase). This book shows a general option 
with the symbol command (option<arg>) where command is the command 
keyletter, option is typically an option keyletter, and <arg> is 
the number, letter-number, bracketed, or quoted argument of the 
option. The angle bracket characters "<" and ">" are shown to 
highlight the argument; they are never actually part of a command. 
Options have the same format as a complete ReGIS command. 
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Numbers in brackets "[" and "]" are position information (also 
called coordinate or point specifiers) . This book shows a general 
position with the symbol [<position>] , where <position> = "x" or 
",y" or "x,y". The first number is the x-axis or horizontal 
position, and the second number is the y-axis or vertical 
position. A comma separates the two numbers. When only one 
number is in brackets without a comma (or with a comma after it), 
it is a new x position while the y position stays the same. When 
only one number is in brackets with a comma in front of it, it is 
a new y position while the x position stays the same. When the 
numbers do not have + or - signs with them, the position given is 
absolute (refered to the origin) . When the numbers do have + or - 
signs with them, the position is relative (refered to the current 
position). At power up, the position coordinates have [0,0] at 
the top left corner of the screen and [767,479] at the bottom 
right corner of the screen. (See Screen Addressing Definition, 
S(A), to change the coordinate system.) 

Examples: 

[200,100] is absolute, x = 200, y = 100. 

[+200,-100] is relative, x = current + 200, y = current - 100. 

[200] is absolute, x = 200, y = unchanged (same as [200,+0]). 

[+200] is relative, x = current + 200, y = unchanged. 

[,100] is absolute, x = unchanged, y = 100 (same as [+0,100]). 

[,-100] is relative, x = unchanged, y = current - 100. 

If a key letter has one or more numbers after it with no 
parentheses, brackets, or quotes, the numbers are pixel vectors. 
These are position information that specifies movement in one of 
eight possible directions. This book shows general pixel vectors 
by the symbol <pv> or <pixel vector> after a key letter. See the 
Position command for more information. 

Quotes indicate characters that the Text command can put on the 
screen as they appear. Both ' and " are quote characters. This 
book shows a general text string with the symbols 'text' or 
"text". The Text command explains quotes in detail. 

Commas and Spaces 

Parenthesized commands can appear next to each other (except for 
E) or they can be separated with commas, spaces, or other control 
characters. Separated commands are easier to read and are good 
ReGIS practice except when the communication line speed limits 
performance. (See Screen Erase for E's special restriction.) 

Control Characters 

ReGIS ignores control characters (columns and 1 of Table 4-1 
plus space and delete) . The VT125 (which supervises the 
communications between ReGIS and the communication lines) , 
monitors the data for ESC. If ESC appears, the VT125 checks for 
the String Terminator sequence. If the sequence is the String 
Terminator (ESC \) , the VT125 returns to text mode. If the 
sequence is a control function that applies to the graphics 
processor (DA, DECID, DECTST, DSR, MC , RIS, see Chapter 4), its 
action is performed. Any other characters after ESC pass to ReGIS 
as ReGIS commands, not as ANSI control functions. 

5-3 



Because ReGIS ignores control characters, ReGIS command strings 
can be formatted to make them easy to read. In particular, 
spaces, carriage returns, and line feeds can be in the listing of 
ReGIS commands as instructions to the terminal or printer for page 
formatting for display. Most of the commands in this book are 
shown with spaces between key letters and option values for 
clarity. The commands can be copied exactly because ReGIS ignores 
the spaces, but to save storage and communication time, all spaces 
can be removed except those inside quoted strings. 

Order of Performance 

As each command arrives, it is acted on. ReGIS always responds to 
each command and option as soon as it has enough information to 
work with. The parentheses, brackets, and quotes described above 
control the way ReGIS responds to the characters of the string. 
For example, a left bracket "[" tells ReGIS to look for a position 
specification. A right bracket "]" ends the position 
specification. If a communication line error or a programming 
error loses the right bracket, all the following ReGIS commands 
will probably be understood incorrectly. The semicolon character, 
if included in the string of commands, clears any control errors 
caused by unmatched sets of parentheses or brackets. This is 
called synchronization. Enough semicolons mixed with commands can 
help get the most usable image on the screen even in the presence 
of communication problems. (A semicolon cannot clear errors 
involving quotes because inside quotes, it is a literal character 
instead of an instruction.) 

An option selection applies to all the following related commands 
unless it is a temporary write option or a curve option. For 
example, giving the W(C) command causes all writing to be in 
complement mode until another writing mode command is given. 
However, a writing control can be a temporary option if it is an 
option to any V, C, or T command. For example, a pixel vector 
multiplier in a screen command applies only to that command, for 
example S (W(M100) ) <pv> . Options can be specified by their option 
key letter in parentheses without the command key letter if the 
given command is still in effect. For example, a line can be 
drawn with the Vector command starting with one intensity and 
ending with another: V (W(I3)) [+100] {W(I2)) [+100]. 

Numeric Values 

The VT125 does all its calculations with integers. This means 
that the smallest meaningful value that it can understand is the 
distance between two pixels. That distance is 1. The terminal's 
coordinate system is designed to address the pixels with integers. 
The VT125 accepts decimal fractions (1.53) and floating point 
numbers (3.21E2) so that images can be transported to higher 
resolution ReGIS devices. However, those numbers are truncated 
(cut off) during processing so that only the integer portions are 
used in calculations, with no rounding (1.53 = 1, 3.21E2 = 321). 
Floating point numbers are truncated to 16 bit signed integers 
(after scaling, if allowed by the coordinate system); values 
larger than (2**15)-1 are kept as (2**15)-1, and values smaller 
than -(2**15) are kept as -(2**15). 
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POSITION 

The most basic concept in the use of ReGIS is the idea of the 
current position. This is a location on the screen with many 
possible functions. It is generally the last position where a 
drawing or command action occured. It may be the location of the 
next pixel to be drawn, it may be the center of a circle, it may 
be the starting point of a vector, or many other things. If ReGIS 
is active in the VT125 but not processing data, a blinking graphic 
cursor appears to mark the current position. The graphic cursor 
is a diamond shape with a cross in it. 

Coordinates 

A coordinate is a number that specifies a position. X-coordinates 
specify horizontal positions and Y-coordinates specify vertical 
positions. A point is the intersection of an imaginary vertical 
line that passes through an X-coordinate and an imaginary 
horizontal line that passes through a Y-coordinate , and so a pair 
of coordinates specifies a point. (The coordinates are sometimes 
called point specifiers in ReGIS documentation.) The general 
symbol for a pair of position coordinates in this book is 
[<position>] . 

When the VT125 is first powered up, it starts counting screen 
positions at the top left corner of the screen. This position is 
called the screen origin and has coordinates [0,0], The 
X-coordinates start at at the left margin of the screen and end 
at 767 at the right margin of the screen. The Y-coordinates start 
at at the top margin of the screen and end at 479 at the bottom 
margin of the screen. With these coordinates, the VT125 can 
address all pixels on the screen with integer numbers. On the 12 
inch monitor screen in the VT125, horizontal pixels are about one 
hundredth of an inch apart. The scan lines, which define the 
vertical pixel spacing, are about two hundredths of an inch apart. 
To let the same number of horizontal and vertical addresses be 
equal distances on the screen, the addressing counts by one for 
horizontal pixels and by two for vertical pixels. (See explanation 
of pixels in Writing Commands.) 

POSITION COMMAND 

The P (position) command sets or changes the current position and 

moves the graphics cursor to the new current position. 

Absolute Position 

Format: P [<x_coordinate ,y_coordinate>] 

This command moves the current position to the 
given coordinates refered to the origin. If a 
coordinate is not signed, it is an absolute 
coordinate. If an x- or y- coordinate is not 
given, its value is unchanged. 
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Relative Position 

Format: P[<+-x change, +-y change>] 



This command moves the current position by adding 
the given numbers to the last current position. If 
a coordinate is signed, it is a relative 
coordinate. If an x- or y- coordinate is not 
given, its value is unchanged. (For negative 
values of change, adding is the same as subtracting 
a positive value.) 



Combining absolute and relative positions 



Absolute and relative values can be combined in one 
command. Sign the coordinate that is relative and 
leave the absolute coordinate unsigned. 



Null Position 
Format: P[] 



This command resets the writing pattern so that the 
next writing operation begins with the first bit in 
the pattern memory. See Patterns in Writing 
Controls. The " [] " argument is a relative position 
specification indicating no change in x or y. 



Pixel Vectors 

Format: P<pixel vector> 



This command moves the current position in the 
direction specified by <pixel vector> (also shown 
as <pv>). A pixel vector is a vector whose length 
is the distance between two pixels times a 
multiplier that is set with a Writing Control 
command. A pixel vector has a limited set of 
directions that it can specify. These are eight 
directions at 45 degree intervals starting at on 
a 360 circle. They are specified by the integers 
through 7 according to Figure 5-1. 

Each time a pixel vector number appears after the 
key letter P, the current position moves one pixel 
multiplier in that direction. Thus, P000 moves the 
current position three pixels to the right. See 
Pixel Multiplier below. 



Temporary Pixel Vector Multiplier 
Format: P (W(M<multipl ier>) ) <pv> 



Sets a temporary pixel vector multiplier for the 
following series of pixel vectors in this command 
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Figure 5-1 Pixel Vector 
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only. The multiplier can be any positive integer. 
Each pixel vector number that follows the 
multiplier moves the current position by the 
multiplier number of pixels. When the VT125 powers 
up, the multiplier is 1, meaning that each command 
moves the current position only one pixel, a very 
small amount. The multiplier increases the power 
of the pixel vector command. 



Begin a Bounded Sequence of Coordinates 

Format: P(B) 



Saves the first position to allow return to the 
beginning position without respecifying that 
'position. The saved position is restored by the 
(E) command. The (B) command can be repeated up to 
10 times and each value of position is saved. Each 
(E) _ command then restores the most recently saved 
position, until the tenth (E) command restores the 
first value saved. The positions stored and 
recalled include those stored in the Vector V(B) 
command. 



Start an Unbounded Sequence of Coordinates 
Format: P(S) 



This command is similar to the (B) command 
explained above except that it specifically does 
not move the cursor at the end of a sequence of 
positions. (S) saves a dummy or non-acting 
position in memory so that the next (E) command 
does not change the current position. Positions 
saved by (S) are in the same memory as (B) 
positions and are included in the ten count. The 
Position (S) command is provided for symmetry with 
the other commands that have (B) and (S) options. 



End a Sequence of Coordinates 

Format: P(E) 



Restores the first position at the end of a P(B) 
command. 

B, S, and E options are used to group sets of 
coordinates together in blocks (position blocks) so 
they can be processed as units, for example, for 
polygon definition or filling or shading 
operations. The position blocks do not have to be 
completed in a single P command, and they can have 
V or C commands inside them. (See B, S, and E in 
Vectors and Curves) 
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Table 5-2 Position Command Summary 

[] 

[<position>] 

<pixel vector> or <pv> 

(B) 
(S) 
(E) 
(W(<temporary writing controls>)) 



Reset pattern memory 

Move to <position> 

Move <multiplier> pixels 
in <pv> direction 

Save current location 

Save dummy location 

Move to last saved location 

P(W(M<multiplier>) ) 



Table 5-2 is a summary of the Position Commands. 
WRITING COMMANDS 

General 

The Writing Commands section explains the ways of specifying the 
locations of pixels for lines, shapes, and text. The next 
section. Writing Controls, explains the attributes of intensity 
and pattern that pixels and shapes can have. The Screen Controls 
section explains the controls for the color and background of 
images, the positioning of the complete image, timing of actions, 
and the production of hard copy output. 

Pixels 

A pixel is the smallest unit of color and intensity information on 
the screen. The intersection of every horizontal address and 
every even vertical address is a pixel. (See Coordinates in 
Position.) The writing commands do two processes at each address. 
They access the address (prepare to write into it) and then act on 
it. The action can be setting bits (see Foreground Planes in 
Screen Controls) , clearing them, complementing them, or perhaps 
doing nothing at all. (See Patterns in Writing Controls.) 

Odd-Y Simulation 

There are 512 defined vertical addresses but only 256 actual 
memory locations. Only every even-numbered vertical address has 
any associated memory. The next higher odd vertical address 
accesses the same pixel memory as the even address. This is 
called odd-y simulation and allows dimensions to be consistent in 
both axes (squares have the same number of addresses on each 
side) . Some combinations of pattern and multiplier may give 
unexpected results because of odd-y simulation. See Pattern 
Multiplier in Writing Controls for more information. 
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VECTOR COMMAND 

The Vector command draws a straight line between the current 

cursor location and a specified screen location. 

Dot at Current Position 

Format: V[] 

This command draws a dot (one pixel) at the current 
position. It is useful because most other vector 
commands do not draw the pixel at the current 
position . 

Vector from Current Position to Specified Position 

Format: V[<position>] [<position>] ... 

This command draws a straight line from the first 
pixel after the current position to the position 
given. Any number of positions can be included in 
the same Vector command to draw a continuous series 
of straight lines. The first dot of each line is 
not drawn so that the next line can connect 
smoothly to the previous line. Use the dot command 
V[] to draw the first dot of a series of vectors. 

NOTE: With shading on, the vector command dra ws 
from the current positionT 

Round-off errors in the VT125's computation of 
vectors can add. The main causes of cumulative 
errors are relative coordinates or non-default 
display addressing (see Screen Controls) , 
especially with non-integer specifiers. If you 
need an absolute position after a series of 
vectors, you should include a Position command. 
This starts the next commands at a known location. 

See Patterns in Writing Controls for details about 
how the Vector command uses patterns. 

Pixel Vectors 

Format: V<pixel vector> 

This command draws a line one pixel multiplier long 
in the direction specified by <pixel vector> (also 
shown as <pv>) . The direction may be any of the 
integers through 7 according to Figure 5-2. The 
direction numbers represent angles at 45 degree 
intervals from (0) to 315 (7) . 

Each time a pixel vector number appears after the 
key letter, the line is drawn one more one pixel 
multiplier in that direction. Any number of the 
eight pixel vectors numbers can appear in the 
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Figure 5-2 Pixel Vector 
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Figure 5-3 Nested (B) and (E) Commands 
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command. Thus, V00066 draws a line three pixel 
multipliers to the right and then two pixel 
multipliers down. (The pixel multiplier is the 
actual number of pixels changed in any command that 
affects pixels. The power-up default is 1 but it 
can be set to any convenient value. See Pixel 
Multiplier in the Writing Controls section.) 

Bounded Sequence of Positions 

Format: V(B) [<posi tion>] . . . [<position>] (E) 

The (B) command saves the current position in the 
graphics processor's memory so that you do not need 
to specify the end position of a sequence of 
vectors that you want to end at the starting 
position. At the end of the sequence, the (E) 
command recalls the position. The Vector command 
then draws a line from the last specified position 
to the saved position. The (B) command can save up 
to 10 positions in memory. Each (E) command 
recalls the position saved by the last (B) command 
and erases the position from memory. The positions 
stored and recalled include those stored with the 
Position P(B) command. Figure 5-3 illustrates the 
action of the "nested" (B) and (E) commands. (E) 
2 recalls (B) 2; the next (E) is 1 which recalls 
(B) 1. 

V (B) l[<positionl>] (B) 2[<position2>] — > 

(E) 2[<position2>] (E) 1 [<posi tionl> ] 

Unbounded Sequence of Positions 

Format: V(S) [<posi tion>] . . . [<posi tion>] (E) 

This command is similar to the (B) command 
explained above except that it specifically does 
not move the cursor or draw a vector at the end of 
a sequence of positions. (S) saves a dummy or 
non-acting position in memory so that the next (E) 
command does not change the current position. 
Positions saved by (S) are in the same memory as 
(B) positions and are included in the ten count. 

The Vector (S) command is provided for symmetry 
with the Open Curve (S) command. (Note that the 
Open Curve command requires null position 
specifiers to draw the same segments as the Vector 
(S) command. These specifiers in a sequence of 
positions do not affect the Vector command except 
for drawing the first dot of a line.) 
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Table 5-3 Vector Command Summary 

[] 

[<position>] 

<pixel vector> or <pv> 

(B) 
(S) 
(E) 
(W(<temporary writing controls>) 



Draw dot at current position 

Draw vector to <position> 

Draw <multiplier> pixels 
in <pv> direction 

Save current position 

Save dummy position 

Draw to last saved position 

V(W(M<multiplier>) ) 



Temporary Writing Controls 

B'ormat: V (W{<temporary writing control options>)) 

The temporary writing control options are the same 
as the Writing Controls command options but they 
apply only during the Vector command that they are 
in. Only options specified or implied by those 
specified are changed. Options return to their 
previous values at the end of the V command. 

Table 5-3 is a summary of the Vector Commands. 

CURVES 

The Curve command draws these members of the family of graphic 
objects called curves. 

• Circles 

• Arcs 

• Closed Curves 

• Open Curves 

A circle is a group of pixels that are all the same distance away 
from a center position. There are two types of curve commands 
that generate circles; they use different information to specify 
the circle. 

An arc is a part of a circle. There are two types of curve 
commands that generate arcs; they use the same information as the 
two circle commands to specify the circle that the arc is part of. 
They also use information to determine what part of the circle is 
drawn. 

A closed curve is a general curve that is made by interpolating 
the locations of pixels around four or more specified locations. 



5-13 



The closed curve is a bounded shape like the circle (which is a 
special case of the closed curve) or an ellipse. 



An open curve is a general curve that is made by interpolating the 
locations of pixels around several specified locations. The 
endpoints of the open curve are not meant to meet. You must pay 
special attention to the endpoints of an open curve to get the 
graphic object that you want. 

Circles 

Circle with Center at Current Position 

Format: C [<position>] 

This command draws a circle around the current 
position with the circumference at the specified 
position. See Figure 5-4. The radius of the 
circle is the distance from the current position at 
the center to the circumference. 

The current position stays at the center after the 
circle is drawn. 

Circle with Center at Specified Position 

Format: C(C) [<position>] 

This command draws a circle around the specified 
position with the current position located on the 
circumference. See Figure 5-5. The radius of the 
circle is the distance from the current position to 
the center. 

The current position stays at the starting location 
on the circumference after the circle is drawn. 

Arcs 

An arc is a part of a circle. It is specified by the location of 
the center of the circle, the radius of the circle, the starting 
position of the arc, and the amount of the circle to be drawn, 
measured in degrees. A complete circle is 360 degrees. 



Arc with Center at Current Position 
Format: C(A<degrees>) [<position>] 



This command draws an arc that is <degrees> around 
a circle starting from <position>. The radius of 
the circle that the arc is a part of is the length 
between the current position and <position>. The 
graphics processor draws the arc counterclockwise 
for the specified number of positive degrees and 
clockwise for negative degrees. The current 
position stays at the center after the arc is 
drawn. See Figure 5-6. 
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Figure 5-4 Circle with Center 
at Current Position 
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Figure 5-5 Circle with Center at 
Specified Position 
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Figure 5-6 Arc with Center at 
Current Position 
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Arc with Center at Specified Position 

Format: C(A<degrees> C) [<position>] 

The command draws an arc that is <degrees> around a 
circle starting at the current position. The 
center of the circle that the arc is a part of is 
at <position>. The radius is the distance between 
the current position and <position>. The graphics 
processor draws the arc counterclockwise for the 
specified number of positive degrees and clockwise 
for negative degrees. The current location is at 
the end of the arc after the arc is drawn. See 
Figure 5-7. 

OPEN AND CLOSED CURVES 

Interpolation of curves 

Given a sequence of positions, ReGIS can draw a curve between the 
positions. The curve represents a generalized nonlinear function 
that intersects all the specified positions. It is generalized 
because it is not the result of the actual function that specified 
the points. It is the result of a graphic technique that produces 
a reasonable imitation of a function curve. The curve indicates 
the presence of a nonlinear function, rather than the function 
itself. You cannot get accurate intermediate values from a 
graphics processor curve unless you have given enough positions to 
ensure that the curve generator is closely following^ your 
function. The curve generator can produce a curve segment with as 
few as four positions. The result can be misleading if the 
positions are too far apart to define the function by themselves. 

Unbounded (Open) curves 

Format: P [<position>] C (S) [] [<position>] . . . [<position>] [] (E) 

An open curve is a general curve that is made by 
interpolating the locations of pixels around 
several specified locations. The endpoints of the 
open curve are not meant to meet. See Figure 5-8. 
You must pay special attention to the endpoints of 
an open curve to get the graphic object that you 
want. The open curve command can draw a curve 
segment with as few as four positions including the 
position preceeding the (S) command. To ensure 
that segments are drawn between all given 
positions, include null position specifiers ([]) at 
the beginning and end of the list of positions. 
Otherwise, only the segments from the second to the 
next to last positions are drawn. 

The current position stays at the next to last 
position specifier after the curve is drawn. When 
null specifiers are used, the last position and the 
next - to - last position are the same. 
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Figure 5-7 Arc with Center at Specified 
Position 
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Figure 5-8 Unbounded (Open) Curves 
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Bounded (Closed) curves 



Format: 



P[<position>]C(B) [<position>] . . . [<position>] (E) 

A closed curve is a general curve that is made by 
interpolating the locations of pixels around four 
or more specified locations. The closed curve is a 
bounded shape like the circle (which is a special 
case of the closed curve) or an ellipse. See 
Figure 5-9. The (B) command saves the beginning 
position and the (E) command closes the curve by 
providing the beginning position as the last 
position specifier for the curve command. 

The current position returns to the second position 
specifier after the curve is drawn. 

Temporary Curve Writing Controls 

Format: C (W( temporary writing controls)) 



The temporary writing control options are the same 
as the Writing Controls command options but they 
apply only during the Curve command that they are 
in. Only options specified or implied by those 
specified are changed. Options return to their 
previous values at the end of the C command. 

Table 5-4 is a summary of the Curve Commands. 



Table 5-4 Curve Command Summary 
C { [<position>] 



(C) [<position>] 



Circle with Center at Current 
Position, Circumference at 
<position> 

Circle with Center at 
<position>. Circumference 
at Current Position 



(A<degrees>) [<position>] 



(A<degrees>C) [<position>] 



(B) [position] . . . [position] (E) 

(S) [] [position] . . . [position] [] (E) 

{W(temporary writing controls)) 



Arc with Center at Current 
Position, starting at 
<position> for <degrees> 

Arc with Center at <position>5 
starting at current position 
for <degrees> 

Bounded (closed) curve 
Unbounded (open) curve 



5-20 



C32«,16e 



[23«,2401 

START 

POSITION 




END PQSITICW 
[48«,12«] 

4 [579, 160] 



[480,249] 



[329,2801 



p[230,24ei c(b)[320,16«] [480,1201 
[570,1601 [489,240] [320,2801 (e) 



Figure 5-9 Bounded (Closed) Curves 



MA-9446 



5-21 



TEXT 

General 

The graphics processor displays characters differently from the 
text terminal. The ReGIS Text command can draw characters with 
many combinations of size, orientation, and position. This 
section explains the Text commands. 

The Text command is formatted as a keyletter followed by options 
and a quoted string. All options in the T command, except 
temporary write options, apply to all following T commands until 
they are changed in another T command. ReGIS understands that two 
quotes of the same kind next to each other, inside a string that 
is delimited by the same kind of quote, means that one quote is 
supposed to be displayed inside the string. But with both kinds 
of quotes available, you can include one kind or the other inside 
the string without having to double it up. Two strings delimited 
by the same kind of quotes can be concatenated by separating them 
with a comma. For example, "stop*" , "here" is the same as 
"stop*here". Empty strings are allowed (""), because doubling 
only occurs inside a string. There is no defined upper limit on 
the length of a string. 

ReGIS never uses the characters inside a pair of quotes or double 
quotes as commands. These include the semicolon synchronization 
character and the macrograph definition and invocation characters. 
Printing characters (space through ~, octal 40 through 127, see 
Character Sets in Chapter 4) are displayed according to the 
pattern stored in the currently-selected alphabet. (This defaults 
to ASCII.) All control characters except CR, LF, HT, and BS are 
ignored. 

CR (carriage return) moves the active position to the position it 
had when the current quoted string began to be drawn. LF (line 
feed) moves the active position down a distance equal to the 
current vertical cell size. HT (horizontal tab) acts as a 
non-printing space. HT moves the active position forward one 
character position without affecting any image in that character 
position. BS (backspace) moves the active position back one 
current text spacing distance to the last written character 
position. This is the simplest method of performing an overstrike 
(drawing two characters in the same place, such as zero with a 
slash) . 

The initial position in a text command is the current position at 
the end of any other writing command. This position is the top 
left^ corner of the next character to be drawn. The size and 
spacing values of the text command then control where the next 
current position occurs. 
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TEXT COMMANDS 
Initial Text Defaults 



When the VT125 graphics processor first powers up, 
many of the Text commands listed in this section 
have default values assigned. The defaults allow 
the graphics processor to respond immediately to 
many of a novice ReGIS user's commands. General 
applications should include text command 
specifications at the beginning of each graphic 
image to ensure the needed state of the graphics 
processor at the time of image generation. The 
defaults are: T[+9,+0] (SI, H2, S[9,20], M[l,2], 
D0, 10), 



Text 

Format: T 'text' 



This is the basic form of the text command. It can 
be used when the states of the options are known to 



be correct. 
Text Character Cell Size 
Format: T(S<size number>) •<text>' 



This command selects a character cell size from a 
standard set of sizes that are multiples of a 
predetermined width of 9 and height of 15. The 
sizes are numbers in the range of to 16. The 
resulting character cells are the size number times 
9 pixels wide and the size number times 15 pixels 
high, except for size characters that are 5 X 10 
pixels in size, and size 1 characters that are 9 X 
20 pixels in size. The size 1 characters are close 
in size and vertical spacing to the VT100 
characters. 

The rest of this section refers to the region 
defined by a bit in the character cell memory as a 
unit, because the commands in this section allow 
text that has more than one pixel controlled by 
each bit. 

A standard character cell is 9 units wide by 15 
units high. The character that is displayed in the 
cell is 8 units wide and 10 units high. (80 pixels 
are stored for each character in the graphics 
processor's character memory.) This standard 
combination of cell and character sizes results in 
one horizontal unit and five vertical units of 
spacing between characters. 
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Because of the default character cell size that is 
selected with this command, there is room for 9 
horizontal units of pattern in the default cell but 
there are only 8 units of information available. 
To fill the ninth space, the graphics processor 
copies the pixel from the first position of the 
character pattern. (See Figure 5-10) Most of the 
characters of character set (the permanent set) 
are only seven pixels wide and are right justified 
in their pattern cells. Therefore, the first pixel 
of each scan of the character is dark. When this 
first pixel gets copied to the ninth position in 
the cell, the ninth position is also dark. The 
result is seven pixel wide characters that are 
spaced two pixels apart. 

Because the first pixel of a cell is copied into 
the ninth position, continuous patterns like the 
underline of character set can be drawn. If a 
character has the first pixel visible but you do 
not want that pixel repeated, use the explicit 
character specifiers as shown in following command 
descriptions to obtain an eight pixel wide 
character cell instead of the default nine pixels 
of this command. 

All of the values that are set by default in this 
command can also be set or modified by using the 
following group of explicit character specifiers 
together. This group of specifiers also 
illustrates the parameters that are set by the S 
command. The pairs of commands shown in Table 5-5 
are equivalent and provide nine pixel wide 
character cells: 



Table 5-5 Text Size Command Equivalents 

Character Character Pixel 
Spacing Cell Size Multiplier 



T{S1) = T [+9,+0] (S[9,20] M[l,2]) 
T(S4) = T [+36, +0] (S[+36,+60] M[4,6]) 
T(S16) = T [+144, +0] (S[144,240] M[16,24]) 
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Figure 5-11 Text Character 
Spacing 
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Text Character Height Multiplier 
Format: T(H <multiplier> ) 



Use this command to select a non-standard character 
aspect ratio when using the Text Character Size 
command. <multiplier> is an integer from 1 to 25 
which multiplies the 10 pixel height of the 
character pattern after the Character Size command 
sets the standard width. The largest multiplier 
causes a character which is within 5 pixels of the 
largest character cell size possible (255) . (Larger 
values cause distorted and incomplete characters.) 



Text Character Spacing 

Format: T [<position>] (<options>) 



The spacing option follows the T command keyletter 
before any parenthesized options. It is a relative 
position specifier that indicates the distance and 
direction that the active position must move from 
the top left corner of one character to the top 
left corner of the next character. See Figure 5-11. 
Use this command with the Text Character Cell Size 
and Text Pixel Multiplier commands. The default 
spacing used with the S<integer> command is [+9,+0] 
which leaves one pixel between characters and keeps 
all characters on the same horizontal line. 

The spacing option values are always relative and 
the option always sets both x and y every time it 
is used even if a value is omitted. Therefore, an 
omitted value causes that dimension of spacing to 
be set to relative 0, which means draw the next 
character at the same x or y position. For 
horizontally arranged text, the y value can be or 
omitted. If the x value is also or omitted, the 
following characters are all drawn in the same 
location (ove rstr i k ing ) . (Note: For occasional 
overstrikes, use the Backspace control character in 
the text string.) 



Text Pixel Vector Spacing 
Format: T <pv> 



This nonparenthesized command uses pixel vector 
numbers to indicate directions of offset for 
characters. The amount of offset is determined by 
the size of the characters, and is one half of the 
given character's size in the direction of 
movement. The pixel vector multiplier does not 
apply. The vector direction is relative to the 
character baseline so this command is affected by 
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the Tilt Direction command. The pixel vector 
numbers can appear anywhere in a command except in 

quotes. 

From the pixel vector directions given in Figure 
5-12, T6 makes the following characters appear as 
subscripts, moved down from the current baseline by 
one half character height. T2 produces 
superscripts, and T44 moves a character back one 
complete character width to produce an overstrike. 
Offsets up and down from the character baseline 
must be followed by reversing offsets to put the 
rest of the characters back on the baseline. 



Text Character Cell Size 



Format: T(S[<width in pixels> ,<height in pixels>] ) 



This sets the size of the area on the screen that 
is drawn by a single character T command. The 
maximum area specifier is [255,255]. (Larger 
specifiers are counted modulo 256.) Use this 
command with the Character Spacing and Text Pixel 
Multiplier commands to select non-standard 
character sizes and aspect ratios. A cell with room 
for 8 horizontal units and 15 vertical units is 
some multiple of [8,15]. (Compare to sample S 
option in Character Cell Size.) 

See Figure 5-13. If the cell is smaller than the 
character that appears in it, the character is cut 
off at the right and bottom edges. If the cell is 
larger than the character that appears in it, the 
character repeats as many times as possible across 
the width of the cell, and the alphabetically next 
characters in the character set appear sequentially 
and repeatedly along the remaining height and width 
of the cell. 



Text Pixel Multiplier 



Format: T(M[<width mult> , <height mult>]) 



This command specifies how many pixels in the 
display will be controlled by each pixel in the 
character pattern. The command multiplies the 
pixels of each character by the given width and 
height multipliers. The maximum multiplier is 
[16,127]. (Larger specifiers set the multipliers to 
the maximum values.) Use this command with the 
Character Spacing and Character Cell Size commands. 

If a character cell has been selected that is 18 x 
30 pixels in size, for example, pixel multipliers 
of [2,3] must be selected to adjust the character 
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Figure 5-13 Text Character 
Cell Size 
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to fill the cell. This example is a standard size. 
Many other combinations are possible. See Figure 
5-13 (above) for more examples. 



Text String and Character Tilt Direction 

Format: T (D<direction angle> S<size>) 

This command affects different parts of the display 
depending on how it is formatted. The simplest form 
of the command is given above; this controls the 
tilt of the baseline for a text string. A text 
string can be tilted at any 45 degree interval 
(either positive or negative) , on a 360 degree 
compass. (See Figure 5-14.) Compass values other 
than 45 degree intervals are translated as the 
nearest lower 45 degree increment. The Size command 
can be a repeat of the last chosen value or a new 
value but must be included to provide correct 
baseline direction and character spacing. 
Characters reading from left to right are not 
tilted if the baseline is at degrees, and they 
are upside down if the baseline is at 180 degrees. 
(See Figure 5-15.) You may need to adjust the size 
for tilted characters because ReGIS does not 
control the scaling between horizontal or vertical 
and diagonal characters. 

The next form of the command controls both the text 
string baseline tilt, and the tilt of individual 
characters in the string. 

Format: T(D<string tilt> S<size> D<character tilt>) 

By including a Size command in the option list, you 
use the same Direction keyletter twice. The first 
value sets the tilt for the complete text string, 
and the second value sets the tilt for each 
character in the string. See Figure 5-15. 

The D command works by setting the tilt of 
characters. Then the Character Size <number> 
command uses the angle specified by D to calculate 
the spacing needed to position the tilted 
characters on a common baseline. (Character Size 
[x,y] must have explicit spacing information and 
cannot calculate it from the D value.) After 
spacing information is calulated by the SO 
command, another D command changes the character 
tilt again to the final value before drawing 
starts. 

Some display combinations can also be produced with 
other commands. For example, many values of string 
direction other than 45 degree intervals can be 

5-29 



90 
-270 



180 



135 


45 


-225 V 


y-315 


225 y/ 


\315 


135 


-45 



270 
-90 



Figure 5-14 360 Degree Compass 
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Figure 5-15 Text String and Character 
Tilt Direction 
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Table 5-6 Italic Tilt Values 

Italic Approximate 
Specifier Angle 



+ +0 

+ 1 +2 

+ 2 ±3 

+ 3 +5 

+ 4 +6 

+ 5 +7 

+ 6 +8 

-1-7 +10 

+9 +13 

+11 +15 

+13 +20 

+19 +25 

+31 +45 



drawn with the explicit spacing command. And if the 
string tilt is 0, the Italic command gives better 
results and more values of character tilt without 
requiring a spacing command. 



Text Italic Tilt 

Format: T(I<Italic degrees>) 



The Italics command tilts the vertical lines of 
individual characters without tilting the 
horizontal lines. Table 5-6 lists the values of 
tilt that are available in the VT125 and the 
specifiers needed to get them. Positive specifiers 
tilt the characters to the left according to the 
compass directions in Figure 5-15 (above) . Note 
that the actual angles of tilt are approximate, and 
smaller tilt angles may distort small characters. 
Specifiers between the listed values set the tilt 
to the next lower value. This command can be used 
with the D command. See Figure 5-16. 



Select Text Character Set 
T(A <character set number>) 



This command selects the character set that is used 
for all text commands until another set is 
selected. The number can be 0, 1, 2, or 3. Set is 
the default character set which is ASCII and cannot 
be changed. Sets 1, 2, and 3 are user loadable 95 
character memories. (See Pattern Cell Controls 
section of this chapter.) If a character cell has 
not been loaded, it is displayed as a filled in 
block. 
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Figure 5-16 Text Italic Tilt 
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This command only selects a character set for 
display. See Pattern Cell Controls for the command 
that selects a character set for loading. 

Store and Restore Options 

Format: T (<current options>) •<text>' 

(B) (<temporary options>) '<text>' (E) 

All text options controlled by the T command can be 
saved as a unit and later restored to their saved 
settings. The (B) command saves the current text 
option values in the graphics processor's memory. 
You can make changes to one or more of the current 
options with another T command and display text 
with the changed options, and you can draw other 
graphic objects. Then, the (E) command restores the 
saved option values for the following text display. 
Only one set of options values can be saved at a 
time. This feature allows you to temporarily change 
the text display options without needing to 
respecify the original values when you return to 
them. 

Temporary Writing Controls 

Format: T(W( temporary writing controls)) 

This command allows writing control options that 
only affect text drawn during this particular 
command. Usually, writing control options stay 
active for all following writing commands until 
they are respecified. The temporary writing 
controls command allows temporary changes to color 
specifiers, writing modes, etc, during the text 
command that they are in. The writing controls that 
are in effect for all commands except this 
particular text command stay unchanged. See the 
Writing Controls section for the formats of writing 
controls options. 

Table 5-7 is the Text Command summary. 

WRITING CONTROLS 

This section describes the attributes of intensity and pattern 
that pixels and shapes can have, and explains the commands that 
control the attributes. 

Initial Writing Control Defaults 

When the VT125 graphics processor first powers up, 
many of the writing controls listed in this section 
have default values assigned. The defaults allow 
the graphics processor to respond immediately to 
many of a novice ReGIS user's commands. General 
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Table 5-7 Text Command Summary 



(S <size number>) 

(H <height>) 

[<spacing>] 

(S [<width in pixels> ,<height in pixels>] ) 

(M [<width pixel multiplier> ,<height pixel multiplier>] ) 

(D <direction angle>) 

(D <string tilt> S <size> D <char tilt>) 

(I <italic degrees>) 



(A <pattern set number>) 

((B) <temporary attributes block> (E) ) 

(W(temporary writing controls)) 



applications should include writing control 
specifications at the beginning of each graphic 
image to ensure the needed state of the graphics 
processor at the time of image generation. The 
defaults are: W(V, I(W) , F3, Ml, N0, PI, P(M2), 
S0) . 

Writing Modes 

The four writing modes. Complement, Erase, Replace, and Overlay, 
can be used at any time, but only one at a time. They control the 
way pixels are placed in a graphic image, and their major effects 
are visible when a part of the image already exists. 
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Figure 5-17 Complement Writing 



Table 5-8 Complementing the Foreground 
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Complement Writing 



Format; 



W(C) 



During a write, complement the bit pattern of the 
foreground specifiers (see Foreground Planes) of 
the pixels present in the existing image wherever 
the pattern register (see Patterns) is 1 and do not 
change wherever the pattern register is 0. See 
Figure 5-17. Complement writing is generally 
reversible by repeating the same command. 
Complementing the foreground specifier gives the 
results shown in Table 5-8. 

Use the Foreground Planes command to get other 
combinations with Complement writing. 
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Figure 5-18 Erase Writing 



Erase writing 
Format: (E) 



Write each pixel with the background specifier if 
negative writing (W(N0)) is off, or write each 
pixel with the foreground specifier if negative 
writing is on. See Figure 5-18. This command does 
not use the pattern register. 
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Figure 5-19 Replace Writing 



Replace writing 



Format : 



(r; 
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Replace the current image with a new image. 
♦Background areas in the new image and * Areas 
where the pattern memory is erase the parts of 
the current image that were in that area. 

Figure 5-19 shows boxes written with replace 
writing in which part of the shaded area of the 
upper box has been replaced with the shading 
pattern of the lower box. 
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Figure 5-20 Overlay Writing 
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Overlay writing 

Format: (V) 



Write a new image on top of the current image, 
wherever the pattern memory is 1, without erasing 
any part of the current image. Blank areas in the 
new image and areas where the pattern memory is 
have no effect on the overwritten area. This is 
the default option in the VT125 graphics processor. 
Figure 5-20 shows boxes written with overlay 
writing in which part of the upper box is written 
with both its original pattern and also the new 
pattern of the lower box. 



Foreground Planes 
Format: W(F <integer>) 

<integer> = 



= no planes 

1 = plane 1 

2 = plane 2 

3 = planes 1 and 2 
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Any pixel can have four choices of appearance 
because there are two bits of memory for each pixel 
in the graphics processor. This command gives you 
control over the individual bits for each pixel in 
writing commands. (Screen Erase always clears all 
bits.) 

Each of the 196,608 pixels in the graphics 
processor has two bits in the display memory. Each 
bit is in one of two identical planes of bits that 
have addresses that correspond to the display's 
pixel addresses. See Figure 5-21. The graphics 
processor uses both bits when it displays each 
pixel. 

The two bits hold an address that selects one of 
four intensities and colors that the graphics 
processor can display at one time. These 
intensities and colors are set with the Screen Map 
control and are stored in the Output Map. The 
address stored in a pixel's two bits controls which 
of the four intensities and colors that the pixel 
has on the display. 

The Foreground plane command lets you write each of 
the bits individually by limiting the write 
commands to one plane or the other. This has three 
main applications: 

1. Suppose you want to use complement mode 
(perhaps because its effects are reversible by 
repeating the same command) to change an object 
from 13 (Intensity 3) to 12. During complement 
writing, both bits are changed. When both bits 
change (see Figure 5-21) , the object changes 
from 13 to 10. But turn off Plane 1 writing 
and only complement the low bit and you get 12. 
Or turn off Plane writing, only complement 
the high bit, and you get II from 13. 

Figure 5-21 shows the process of writing the 
graphic memory with pixels controlled by the 
writing commands. The writing commands select 
the individual pixels to be written, the 
pattern controls whether the selected pixel 
changes or not, and then the Foreground Planes 
command controls which of the two planes can be 
written. The four addresses that the two bits 
form in the planes are shown for pixels (x,y) , 
(x,y+l) , (x,y+2), and (x,y+3) in the figure. 
These addresses point to the four values of 
intensity and color that are stored in the 
output map. 
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Figure 5-21 Foreground Planes and the Output Map 
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To select the right plane to write, see the 
figure. Complementing a pixel means that the 
two bits in memory for that pixel are changed 
to their opposite values. Complementing both 
bits means that if the intensity is 13, its 
complement is 10, and if the intensity is 12, 
its complement is II. 

Note the binary to decimal conversion and the 
output map in the figure. To change from 13 
(White or Green) to 12 (Light Grey or Red) is a 
one bit change in Plane with no change in 
Plane 1. But Complement changes the bits in 
both planes. By using the Foreground Planes 
command to turn off writing to Plane 1 (W(F1)), 
you can use the complement command to change 
pixels from 13 to 12. 

Remember to restore writing to both planes when 
you finish single plane writing. 

2. One plane can hold a fixed image, like a graph 
grid, and the other plane can hold overlays 
that you can write in replace mode without 
redrawing the grid. 

3. Another application for the Foreground Planes 
command is the alternate display (including 
blinking) of two graphic images. The graphics 
processor takes a noticable amount of time to 
draw most images into its memory. This drawing 
time makes blinking or other closely timed 
visual effects difficult to do. However, if 
you can afford to use only two colors or 
intensities in your images, you can use the two 
foreground planes as two separate graphic 
memories that can be drawn in with full pixel 
resolution . 

Foreground Intensity and Color 

Format: W(I<integer>) or W(I(<letter)) 

or W(I (H<hue>L<lightness> S<saturat ion>) ) 

This command selects the appearance of the graphic 
objects that are drawn after this command from a 
range of four values that were entered into the 
output map by the Screen Output Map Definition 
(S(M)) command. An integer specifier selects one of 
the four output map values, A letter or HLS 
specifier makes the graphics processor compare the 
specifier with the four values stored in the color 
output map. The integer specifier that was defined 
to hold the color output map value that is closest 
to the foreground definition then becomes the 
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foreground value. This command cannot store a value 
in the output map but only selects from the 
available choices. If the letter or HLS specifier 
in this command is too different from the current 
output map values, the graphics processor may not 
find a close enough value and may give 
unpredictable results. 

Any pixel can have any of the four values of 
monochrome intensity (for the internal monitor) and 
color hue, lightness, and saturation (HLS for the 
external color monitor) . However, one value in the 
map is used as the background specifier (see Screen 
Background (S(I) and Screen Erase (S(E)), so any 
object drawn with the background color or intensity 
should be drawn on top of another object or it will 
not be visible. 

Any pixel can have four choices of appearance 
because there are two bits of memory for each pixel 
in the graphics processor. See the Foreground 
Planes command for control over the individual bits 
for each pixel. 

The default value is 13 or 1(G) or I (L100) . 

Pixel Vector Length Multiplier 

Format: W(M <multipl ier>) 

This command sets the number of pixels that 
pixel-related Position and Vector commands move or 
draw in one step. The default and minimum value is 
1 pixel, and the maximum is 255. (Larger values 
modulo 256; is set to 1.) 

Negative writing 

Format: (N 1) = negative on (N 0) = negative off 

Negative writing inverts the effect of the pattern 
memory. For writing commands that use the pattern 
memory, where the memory is 1, the background is 
written, and where the memory is 0, the foreground 
is written. 

Shading 

The shading commands let you fill the inside of a graphic object 
with the same command you use to describe the outline of the 
graphic object. When shading is on, the vector and curve commands 
operate as usual. But starting at each pixel on the vector or 
curve path, the graphics processor draws a line to the shading 
reference line. The shading reference line is the horizontal line 
whose Y-coordinate is specified when shading is turned on. The 
default shading reference is the current Y-coordinate. You can 
specify a different shading reference line in the shading command. 
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The default writing pattern used when writing the shading lines is 
the current writing pattern, which also has a default value of all 
I's. You can specify a text character from any of the graphic 
processor's character sets to be used as the shading pattern. 
Such shading can be used for area fill, but the graphics processor 
does not automatically ensure that arbitrary areas are completely 
and correctly filled; you must ensure that the correct reference 
lines are specified to get the shading effect that you want. 

Shading with a pattern can provide density or "half-tone" effects. 
If you are limited to two intensity values, as for example with 
the LA34-VA hard copy printer, you can get grey scale effects by 
shading with different density characters. Use the Character Cell 
controls to define a set of characters that have different numbers 
of pixels dark, and use them as shading characters. The same 
technique can let you mix colors at the pixel level. Define 
characters that have the same number of pixels dark but that have 
the pixels offset from character to character. Then overlay write 
the graphic object with the different shading characters using a 
different foreground color for each character. 

Shading On or Off 

Format: W(S1) = shading on 
W(S0) = shading off 

This command turns shading on for area fill. The 
current Y-position is the shading reference line 
unless you include the reference line command, 
below. The S(E) command turns off shading and sets 
the shading reference line to the current position. 

Shading character 

Format: W(S 'shading character') 

Turn shading on (same as SI) and use the shading 
character in single or double quotes to provide a 
particular pattern for area filling. (See 
Patterns.) Use the Text command to select a 
character size or character set before specifying 
the shading character. When characters from the 
character set are being used as a shading pattern, 
only the first eight (of ten) lines of character 
pattern are used. 

Shading reference line 

Format: W(S [ ,<y-position>] ) 

Including a Y position in a shading command sets 

the shading reference line to the needed position 

for proper fill of the graphic object to be drawn. 

' This command is used with the Shading On or Shading 
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Character commands. Used by itself, this command 
turns shading on and clears the shading character 
(same as SI) . 

The shading is drawn from pixels on the outline of 
a graphic object to the reference line. If that 
line is in the wrong place, the shading can cover 
parts of the graphic object. For example, a 
reference line that is above a circle will cause a 
solid U shape to appear. The reference line needed 
for a circle is in the middle, where the x 
dimension is largest. 

Other graphic objects can be more difficult to 
shade, particularly if they are concave on their 
left or right sides. See Figure 5-22. A general 
rule is to draw such objects in two or more 
sections, putting the shading reference line above 
one section and below the other. Shading patterns 
are always aligned everywhere in the display, so 
objects can appear continuously shaded even if they 
are generated in separate operations. 

Shading with patterns (using the W(P) commands) 
gives horizontal pattern lines. This is because 
the command to shade to a reference line actually 
draws a series of vertical vectors to that line, 
using the pattern. 

The S(E) command turns off shading and sets the 
shading reference line to the current position. 

Patterns 

Patterns allow you to vary the appearance of lines and shaded 
areas in a graphic object. The typical drawing process sets all 
pixels in the graphic object either to one of the three foreground 
intensity (or color) values or to the background value. A pattern 
keeps some of the pixels of the graphic object at the background 
value while the rest change to a foreground value. The pattern 
does not have to be related to the graphic object's outline. 

Patterns are stored in a memory which is then read during a write 
operation to control the appearance of pixels in graphic objects. 
For example, a vector command may write a series of pixels in a 
line on the display. As the pixels are written, the pattern 
memory is read bit by bit to determine whether a corresponding 
pixel should have the foreground or background intensity. The 
shading pattern is also controlled by the pattern memory. 

The memory is 8 bits wide, and its default contents are all I's 

(pattern Pi). Other patterns can be loaded into the pattern 

memory, including standard patterns selected by number (Select 

Standard Pattern) , or your own pattern loaded by its bit pattern 
(Specif iy Binary Pattern) . 
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Figure 5-22 Selecting a Shading 
Reference Line 
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Select Standard Pattern 
W(P <pattern number>) 



This command selects a pattern for drawing the 
outlines of graphic objects. The patterns that 
have been included in the VT125 graphics processor 
are listed in Table 5-9. 

(Patterns 6 through 9 are reserved for future 
standardization, but are displayed in the VT125 as 
separated dots so they are visible.) 



Table 5-9 Standard Patterns in the VTI25 



P0 = 00000000 




PI = 11111111 




P2 = 11110000 




P3 = 11100100 




P4 = 10101010 




P5 = 11101010 




P6 through P9 = 


10001000 



Specify Binary Pattern 
W(P <binary pattern>) 



A binary pattern is a two- to eight-bit pattern 
that you can set with I's and 0's. When the 
graphics processor draws on the screen, bits that 
are set to 1 are drawn, and bits that are set to 
appear as gaps in the line. (If negative writing 
is on, the effects of I's and 0's are switched.) 

A maximum of 8 bits can be specified for the 
pattern memory. During the drawing of graphic 
objects, groups of 2, 4, or 8 bits are repeated as 
full subunits. Table 5-10 illustrates the repeat 
methods. 



Table 5-10 2, 4, and 8 Bit Binary Pattern Repeats 



Pattern Pattern 

(Bit #) Repeated (spaces for clarity) 



12 12 12 12 12 12 12 12 12... 

1234 1234 1234 1234 1234... 

12345678 12345678 12345678 12... 
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Groups of 3 are repeated twice and then followed by 
the first two bits of the group before starting 
again. Groups of 5, 6, or 7 are displayed once and 
then followed by the first 3, 2, or 1 bits of the 
group before starting again. Table 5-11 
illustrates the repeat methods. 



Table 5-11 3, 5, 6, and 7 Bit Binary Pattern Repeats 

Pattern Pattern 

(Bit #) Repeated (spaces for clarity) 

123 123 123 12 123 123 12 123... 

12345 12345 123 12345 123 12345... 

123456 123456 12 123456 12 123456... 

1234567 1234567 1 1234567 1 1234567... 



For example, P1100 draws lines dashed with equal 
gap and mark spacing. P11100111 draws dashed lines 
with marks three times as long as gaps (because of 
the pattern repeat). P101 draws a pattern 
1011011010110110 (note that the 3 bit pattern is 
not cyclic over all groups of 3 bits). 

For more variations, use the Pattern Multiplier 
command . 

Set Pattern Multiplier 

W(P (M <pattern mul tiplier>) ) 

The pattern multiplier sets the number of pixels 
that are affected by each bit in the pattern 
memory. The minimum value is 1 pixel and the 
maximum value is 16. (0 does not change the 
setting. All other values set the multiplier to 
16.) Figure 5-23 shows the pattern memory and 
multiplier in operation. The default multiplier is 
2 so the interaction of the write modes and some 
patterns does not prevent graphic objects from 
appearing the way you want. This makes odd-y 
simulation work to let a square have the same 
number of addresses in both axes. 

Custom Writing Control Definition 

Format: W (W< i> (P< j> ,N<k>) ) 

This command defines the values that replace a 
specific value of current contents at a pixel 
location. The contents of the pattern memory 
selects which of the two values is used. The 



5-47 



PATTERN MEMORY 



11101010 



MULTIPLIER = 2 



PATTERN STARTS HERE AT 
-BEGINNING OF WRITING COMMAND 
ORP[]. 



DISPLAYED LINE 



DARK AREAS REPRESENT PIXELS THAT ARE CONTROLLED BY ONE'S. 
LIGHT AREAS REPRESENT PIXELSTHAT ARE CONTROLLED BY ZERO'S. 



Figure 5-23 Pattern Memory and Multiplier 
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Figure 5-24 Custom Writing 
Control Command 
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command must be expanded to define the complete 
writing control. See below. Numbers are in the 
range to 3 . 

<i> = 

current pixel contents (repeat for through 3) . 

<j> = 

writing value (0 - 3) if pattern memory bit is 1. 

<k> = 

writing value (0 - 3) if pattern memory bit is 0. 

The VT125 has several writing controls that define 
the effects of a writing operation on the display. 
Standard writing controls provided include, for 
example. Complement and Overlay. 

Each of the standard writing controls is a 
predefined shorthand use of the W(W) command. You 
can create your own writing control to get the 
effect you want. The W(W) command lets you define 
writing actions for single pixels based on every 
possible combination of bit plane and pattern 
memory contents. 

Figure 5-24 shows that the hardware associated with 
the W(W) command is a one of eight decoder and an 
eight by two bit memory. The decoder has two 
inputs. The current pixel in the display bit map 
supplies the two low bits. The current bit in the 
pattern memory supplies the high bit. The eight 
outputs from the decoder select eight possible 
writing choices for the current pixel. 

The W(W) command loads the eight by two bit memory 
with your choices for new information to write into 
the current pixel location. All the numbers in the 
command represent two bit numbers in the range to 
3. The command introduction is W(W. The next 
number <i> is the current pixel value. All four 
possible current pixel values are inputs to the 1 
of 8 decoder, so the command must be repeated four 
times to change the complete memory. The rest of 
the command is (P<j>,N<k>). P and N are keyletters 
for the contents of the pattern memory. <j> and 
<k> are numbers representing the new information to 
be written. For a given <i>, if the current bit of 
the pattern memory is 1 (P for positive) , then <j> 
is the value that is written. If the current bit 
of the pattern memory is (N for negative) , then 
<k> is the value that is written. 

For example, if the current pixel is and you want 
to change it to 3 if the pattern memory bit is 1, 
and leave it if the pattern memory bit is 0, the 
command is W{W0 (P3 ,N0) ) . 
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W(R), W(C), W(V) , W(E) , W(N)M, W(F<n>) and W(I<n>) 
are actually shorthand expressions for forms of the 
W(W) command. For example, the equivalent of W(C) 
is: 

W(W0(P3,N0) 1(P2,N1) 2(P1,N2) 3(P0,N3)) 

W(F1,R) is: 

W(W 0(P1,N0) 1(P1,N0) 2(P3,N2) 3(P3,N2)) 

W(F3,V,I2) is: 

W(W 0(P2,N0) 1(P3,N1) 2(P2,N2) 3(P3,N3)) 

Specifying any shorthand form sets the complete map 
to the appropriate value. When you use W(W) , only 
those choices you specify are filled in. 
Unspecified values remain as previously set. 

Table 5-12 is a summary of the Writing Controls. 
Table 5-12 Writing Controls Summary 
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Table 5-12 Writing Controls Summary (Cent) 
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SCREEN CONTROLS 

Screen controls are the commands that affect the complete screen 
of the VT125 at the same time. The Screen Controls section 
explains the controls for the positioning and addressing of the 
complete image, the color and background of images, timing of 
actions, and the production of hard copy output. All screen 
control commands begin with S. 

Initial Screen Control Defaults 

When the VT125 graphics processor first powers up, many of the 
screen controls listed in this section have default values 
assigned. The defaults allow the graphics processor to respond 
immediately to many of a novice ReGIS user's commands. General 
applications should include screen control specifications at the 
beginning of each graphic image to ensure the needed state of the 
graphics processor at the time of image generation. The defaults 
are: S[0,0] (A[0,0] [767 ,479] , 1(D), SI, T0) . (See below for M 
defaults . ) 

Screen Scrolling 

Format: S<pv> or S [<posi tion>] 



A window (represented by the display screen of 
VT125 terminal) moves around the screen image, 
window moves its top left corner by a rela 
amount if the specifier is a relative position 
pixel vector, or to an absolute position (meas 
from the origin) if the specifier is an abso 
position. Pixel multipliers apply if the pv for 
used, and the origin is determined by the sc 
addressing option if the position form is u 
(See the Position section above, and Screen Dis 
Addressing below.) Display addresses stay with 
image so the image stays in the same posi 
relative to the origin. See Figure 5-25. 
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DISPLAY WINDOW'S TOP LEFT CORNER MOVES TO 

ADDRESS [100,100] . SCREEN SCALE=2 ma-9433 

Figure 5-25 Scrolling the Display Window 
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If the Screen Scale command (below) changes the 
display of an image, this command moves the display 
window to allow any part of the image to be seen. 
Also, the image scrolls through an address space of 
256 pixels vertically (represented by 512 addresses 
for odd-Y simulation) and wraps from top to bottom. 
The visible area is only 240 pixels (or 480 
addresses) so vertical scrolling allows all of the 
image to be seen. The image wraps horizontally at 
pixel (and address) 768. 



Screen Display Addressing Definition 
Format: S (A[<posi tion>] [<posi tion>] ) 



The addressing option is a compatibility feature 
that lets the VT125 display graphic images that are 
created for other ReGIS devices that have different 
resolutions or address orientations. Use a host 
system's software to do scaling (size) 
transformations and maintain the performance of the 
graphics processor. Scaling transformations done 
by the graphics processor have roundoff errors, 
resulting distortions, and generally produce 
smaller images than expected. Axis transformations 
(for example, moving the origin to the lower left 
corner) may be done by the graphics processor 
because they do not have much effect on the 
performance of the graphics processor and do not 
cause distortions or size changes. 



NOTE 



Pixel vector directions do not change with 



the addressing option. 



The first <position> is the address you want the 
upper left hand corner of the display to have, and 
the second <position> is the address you want the 
lower right hand corner of the display to have. If 
either or both <position> are missing or illegal 
(negative) , the entire option is ignored and the 
display coordinates stay unchanged. The graphics 
processor defaults to a specification of 
A[0,0] [767,479] . 

If the right margin value is smaller than the left 
margin value, the x coordinate increases to the 
left. If the bottom margin value is smaller than 
the top margin value, the y coordinate increases 
going up. See Figure 5-26. There are no absolute 
negative coordinates in ReGIS, so do not specify an 
addressing range that has negative coordinates. 

The graphics processor uses odd-Y simulation. 
Odd-Y simulation means that although the vertical 
resolution of the graphics processor is 240 pixels. 
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Figure 5-26 Axis Address Transformation 
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Figure 5-27 VT125 Addressing Range 
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Table 5-13 Wrap Address Formulas 



Horizontal wrap = 

(X-address option specifier X 4096/767) - 1 
Vertical wrap = 

(Y-address option specifier X 4096/511) - 1 




For compatibilty with future devices that have a 
larger displayable area than the graphics 
processor's screen, and to allow proper computation 
of graphic objects that partially extend into the 
borders of the screen area, ReGIS does not reject 
addresses that are outside the area of the 
displayable screen. The VT125 has a computing 
address space with full resolution that extends at 
least one full screen size in each direction (see 
Figure 5-27) provided that the address option 
specification is less than [16383,16383], If no 
computing address space is needed outside the 
displayable screen, the address option 
specification can be as large as [32767,32767]. 

Beyond a certain address, which varies according to 
the address option specification, the graphics 
processor wraps graphic objects into the opposite 
side of the screen. Wrap addresses greater than 
32767 are invalid. The wrap addresses can be 
calculated with the formulas in Table 5-13. 

The Current Position as reported by the Report 
command is given in the coordinates set by this 
option. If a command has moved the cursor into the 
address space above or to the left of the screen, 
it is in "negative" address space. ReGIS cannot 
use negative addresses but the graphics processor 
reports the location of the current position in the 
form: 65536 + negative location. For example, a 
position 100 pixels to the left of [0,0] is 
computed as 65536 + (-100) = 65436. You cannot use 
this form to address the negative address space. 
Only relative movements from positive addresses can 
move the current position in the negative address 
space. The graphics processor's ability to compute 
locations in the negative address space prevents 
distortions or improper offsets at the negative 
boundaries. It cannot be used to create images for 
display. 
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When the addressing option is set to be any value 
except the default, integer scaling is used so that 
there is a constant integral relationship between 
the number of pixels that are displayable on the 
screen and the number of pixels that can be 
addressed by the coordinates that are selected. 
The result is that images prepared on low 
resolution devices transfer to other low resolution 
devices with constant interval step sizes that may 
waste up to half of the receiving device's display 
area . 



Screen Erase 

Format: S(E) 

Sets the complete screen area to the background 
intensity and color value that was selected by the 
Screen Background Definition (S(I)) command from 
the range of values in the output map set by the 
Screen Output Map Definition (S (M) ) command. The 
current cursor position is not changed. Shading is 
turned off and the shading reference line is set to 
the current position. No other writing controls 
are affected. Any curve interpolation is 
terminated and all (B) , (S) , and (E) coordinate 
blocks are cleared. The contents of the output map 
(see Screen Output Map) are unchanged. 

The E keyletter has a restriction in its formatting 
with other commands. ReGIS understands a string of 
numbers followed by E to mean exponential 
(scientific) notation. Therefore, a comma is 
necessary in the command S(I0,E) to cause a screen 
erase to intensity 0. 

Screen Hard Copy Output 

Format: S(H (P [<position>] ) [<posi tion>] [ <posi tion>] ) 

Generate a hard copy image of the screen area 
within the rectangle defined by the two position 
specifiers. If only one position specifier is 
given, that position and the current cursor 
position define the rectangle. If no position 
specifiers are given, the whole visible screen is 
output. The output image is scaled as the screen 
is scaled by the S(S) command, and the range of 
addresses printed is defined by the two position 
specifiers. 

S (H (P [<position>] ) ) is a command that specifies the 
location of the upper left corner of the hard copy 
image on the paper. The position is measured from 
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the left margin at the current vertical print head 
position. The value set by the P option stays the 
same until it is changed by another P option. The 
default position for hardcopy output is [50,0] to 
horizontally center the image on 8.5 inch paper. 
Unless the P [<posi tion>] option is followed by 
other position arguments, it only sets the image 
corner location without causing a hard copy 
printout. If it is followed by arguments or 
another H keyletter, it causes a printout. 

See the Media Copy control sequence in the Received 
Character Processing chapter under VT125 
Communication and Graphic Control Sequences. With 
Media Copy, the hard copy image output can be sent 
either to the auxiliary port for printing, or to 
the host for storage. 

NOTE; Entering and exiting SET-UP cancels a Hard 
Copy command. 

Most printers can only display two intensities, on 
and off. The VT125 can display four monochrome 
intensities. To generate hard copy output, the 
VT125 puts a dot wherever there is a non-zero 
intensity according to the monochrome output map. 
See Shading in Writing Controls for a method for 
getting grey scale hard copy. 

Screen Background Definition 

Format: S(I<integer>) or S (I (<letter>) ) 

or S{I(H<hue> L<lightness> S<saturation>) ) 

This command selects the appearance of the 
background. The background is the intensity or 
color that the screen has when it is erased (S(E)) 
or when a graphic object is written that specifies 
background writing. The background is selected from 
a range of four values that were entered into the 
output map by the Screen Output Map Definition 
(S(M)) command. An integer specifier selects one of 
the four output map values. A letter or HLS 
specifier makes the graphics processor compare the 
specifier with the four values stored in the color 
output map. The integer specifier that was defined 
to hold the color output map value that is closest 
to the background definition then becomes the 
background value. 

This command cannot store a value in the output map 
but only selects from the available choices. If the 
letter or HLS specifier in this command is too 
different from the current output map values, the 
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Table 5-14 Integer or RBG Colors in the VT125 



Color 

Name RGB HLS 



Dark D L0 

Red R H120 L50 S100 

Green G H240 L50 S100 

Blue B H0 L50 S100 

Cyan (B+G) C H300 L50 S100 

Yellow (R+G) Y H180 L50 S100 

Magenta (R+B) M H60 L50 S100 

White (R+G+B) W L100 



graphics processor may not find a close enough 
value and may give unpredictable results. 

The default value is 10 or 1(D) or I (L0) . 
Screen Output Map Definition 
Format: 
S(M<n> (L<mono lightness>) (A H<hue> L<lightness> S<saturation> ) ) 

<n> is 0, 1, 2, or 3 to select the output map 
section that stores the definition. 

(L<mono lightness>) is an HLS specifier with only 
the L or lightness specifier given, or a letter 
specifier. See Table 5-14. It selects the 
intensity of a given pixel on the monochrome 
monitor in the VT125 terminal. The four possible 
lightness values (dark, dark grey, light grey, 
white) are on a percent scale that is divided into 
four ranges: 0-24, 25-49, 50-74, 75-100. Any 
percentage within a range selects the lightness 
value for that range; for example, L65 selects the 
third value: "light grey". Values are truncated 
to their integer part, so 24.99 is in the 0-24 
range while 25.00 is in the 25-50 range. H and S 
specifiers are ignored in the monochrome part of 
the command. 

(A H<hue> L<lightness> S<saturation> ) is an HLS 
specifier that selects the intensity of a given 
pixel of an external (Alternate) color monitor. 
Many different colors can be displayed using the 
HLS specifiers because the six bits of information 
that each output map holds for the color monitor 
can describe any of 64 combinations. See Figure 
5-28 for an illustration of the range of hues 
available for different levels of lightness and 
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THERE ARE FOUR MONO INTENSITIES. THEY ARE 
SHOWN IN SMALL CIRCLES. 



Figure 5-28 Colors in the VT125 
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Table 5-15 Default Output Map Values 



S(M0 


(L0) 


(A L0) 




1 


{L25) 


(A H0 L50 


S100) 


2 


(L50) 


(A H120 L50 


S100) 


3 


(L75) 


(A H240 L50 


S100) 



saturation. A more limited set of colors can be 
selected using the letter specifiers shown in Table 
5-14. Appendix C explains the HLS specifier system 
in more detail. 

If the graphics processor does not understand a 
specifier, perhaps because it was incorrectly 
formatted, the output map involved is set to a 
default light grey: H L50 S0. There is a set of 
default values for the output map that can be used 
at power-up. The default values can be described by 
the command shown in Table 5-15. 

The VT125 displays color and brightness by 
displaying one of four preset values for each pixel 
on the screeen. The VT125 can display each pixel 
on the screen with a different hue, lightness, or 
saturation. However, it can do this with only four 
different combinations at one time. That is, any 
pixel can be different from its neighbors, but 
there can only be four different pixel colors on 
the screen at one time. 

The VT125 has a pixel memory and an output map. 
For each pixel, there are two bits of information. 
These pairs of bits are in two separate but closely 
connected planes of addressable locations. (See 
Figure 5-21 in Writing Controls.) The pairs of bits 
represent the four numbers 0, 1, 2, and 3 when 
their binary values are decoded. (The Foreground 
Planes command has a more detailed discussion of 
this subject.) 

Each of the four numbers is the address of one of 
four output map locations. Each output map 
location holds a description of one intensity for 
the monochrome display in the terminal, and one 
color for the external color monitor. When the 
pixel memory is being displayed, each pixel bit 
pair indicates the output map location that holds 
the pixel's appearance on the display screen, 
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and saturation for the color monitor. The 
information in each of the four output maps can be 
set using the mapping command with any of the three 
kinds of specifiers: numbers, letters, or HLS. 
Table 5-14 (above) lists the specifications for the 
colors available by integer or RBG letter code in 
the VT125. Many more colors can be defined with 
HLS. Figure 5-29 shows the default values stored 
in the output maps for the internal monochrome and 
external color monitors. 

Specifying anything with A changes a color, 
specifying anything without A changes only the 
monochrome map. Figure 5-30 shows sample 
definitions and the resulting maps. 

Screen Scale 

Format: S(S<scale>) or S (S (X<scale>Y<scale> ) ) 

This command takes the contents of the graphic 
memory and changes the portion of the memory that 
appears on the screen at any one time. If <scale> 
is a number, for example S(S2), use that number as 
the scaling value for both the X and Y dimensions. 
To scale differently in X and Y, put X<number> and 
Y<number> in parentheses at <scale>, for example 
S(S(X2)). Legal values in the VT125 are 1 for 
usual size and 2 for double size. Values less than 
1 are understood as 1 and values greater than 2 are 
understood as 2. Dimensions not specified do not 
change. When the image is enlarged, the upper left 
hand corner of the image stays in the same place, 
so you must offset the display with the Scrolling 
command to see the other areas of the display. See 
Hard Copy for the effects of scaling on that 
command. 

Screen Time Delay 

Format: S(T<ticks>) 

The time delay option causes ReGIS to delay the 
processing of the next command for the specified 
amount of time. Ticks is either 60ths or 50ths of 
seconds, depending on the Power SET-UP feature 
setting. The largest possible number is 255, which 
is approximately 4 or 5 seconds. 

Table 5-16 is a summary of the Screen Controls. 
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Figure 5-29 Default Output Map 



S(M1(AW)) = 

MONO COLOR 

1 [(NOCHANGJi] 1 I WHITE ' 

S(M 2 ( L50) (A HO L50 S 1 001 ) = 

COLOR 



MONO 
2 I LIGHT GREY 

S(M3(L10a)) = 
MONO 
3^ WHITE 



BLUE 



COLOR 



3 (NO CHANGE) 



Figure 5-30 Sample Output Map 
Definitions 
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Table 5-16 Screen Controls Summary 



S { <pixel vector> 
[<position>] 

(A [<position>] [<posi tion> ] ) 



(E) 

(H [<position>] [<position>] ) 

(H (P[<position>] ) ) 



Scroll 



Display 
addressing 

Erase screen 

Hard Copy (corner 
positions optional) 
Set Hard Copy Offset 



(I or 


(D) ) 


1 


(R) ) 


2 


(G) ) 


3 


(B) ) 




(C) ) 




(Y) ) 




(M) ) 




(W) ) 



Background 




Intensity: 




Dark or Dark 


Dim grey 


Red 


Light grey 


Green 


White 


Blue 




Cyan 




Yellow 




Magenta 




White 



or 



(I (H <hue angle> 

L <lightness percent> 
S <saturation percent>)) 

S(M<n> (<mono HLS>) (A<color HLS>)) 



(S <scale>) 

(S (X<scale>Y<scale>) ) 

(T <ticks>) 



Output 
Mapping 



Time Delay 



MACROGRAPHS 

Macrographs are a character string substitution utility provided 
in ReGIS. Strings are command strings or any other string of 
characters that are stored in the VT125 memory and then 
substituted in another command string. Generally, a macrograph is 
a part of or a complete ReGIS command string that is used often. 
ReGIS inserts the contents of the macrograph in the command string 
at the position in the command string where the macrograph is 
invoked , 

The twenty-six letters of the alphabet are the keyletters for 
defining and invoking macrographs, so 26 macrographs can be 
defined. Each macrograph can be as long or as short as needed. 
There are at least 5000 characters of storage available in the 
VT125 memory for all macrographs. 
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A macrograph can invoke another macrograph but not itself, and you 
cannot define a macrograph inside a macrograph (the inner 
terminator terminates the outer definition) or in a quoted string 
(the definition or invocation characters become part of the text 
in a quoted string) . 

Clear All Macrographs 

Format: @. 

This is the same as defining all 26 macrographs as 
null or empty. If this command is inside a 
macrograph, the macrograph is completed and then 
all macrographs are cleared. 

Macrograph Definition 

Format: @:keyletter character_str ing @; 

@: (commercial at-sign and colon) Starts the 
macrograph definition. 

keyletter 

Defines one of the 26 letters of the alphabet to be 
the name of the macrograph. ReGIS ignores the case 
of the letter. If a macrograph with the same 
keyletter was previously defined, it is cleared 
before the new definition is saved. A null 
definition (no characters in the character string) 
is legal and clears any macrograph with that 
keyletter . 

character_str ing 

Specifies the characters that are saved as the 
macrograph. All characters in character_str ing are 
saved including all control characters. The 
macrograph definition start and end characters are 
not included with the saved characters. 
character_str ing has no fixed maximum length, but 
the number of characters saved in all macrographs 
should be less than 5000. 

@; (commercial at-sign and semicolon) 
Ends the macrograph definition and returns ReGIS to 
the command level it had before invoking the 
macrograph. The semicolon does not synchronize the 
command level the way it does at any other place in 
the command string. Do not put a control character 
between these two characters. 
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Table 5-17 Macrograph Command Summary 



@ { . } Clear all macrographs 

{ } 

{ rkeyletter character string @; } Define macrograph 

{ ~ } 

{ keyletter } Invoke macrograph 



Macrograph Invocation 

Format: @ keyletter 

The @ sign and one of the 26 keyletters invokes the 
macrograph with that name and inserts the character 
string in the ReGIS command string in place of the 
@ and keyletter. A macrograph can not be used to 
supply a keyletter for an @ sign: @§ is illegal. 
Invoking an empty macrograph is not an error. 

Table 5-17 is a summary of the Macrograph commands. 

CHARACTER CELL CONTROLS 

The VT125 graphics processor can write text with up to four 
character sets at one time. Each character set has 95 displayable 
characters. One character set is always ASCII but the other three 
can be loaded into the graphics processor's character memory over 
the communications line. 

Select Character Set for Loading 

Format: L (A<integer> ) 

Select one of three loadable character set memories 
in the graphics processor for loading. Set is 
the ASCII character set in the VT125 graphics 
processor and can not be changed. Sets 1, 2, and 3 
can be loaded according to the instructions in Load 
Character Cell below. The Select command can 
include a name as in Associate Name below. 

The Load command selects a character set for 
loading, but the actual loading process does not 
have to follow immediately. Other commands can be 
performed without changing the selection. In 
particular, the Text command selects a character 
set for writing. This Text selection is not the 
same as the Load selection and does not change the 
character set selected for loading. 
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Associate Name with Current Character Set 

Format: L(A"<name>") 

This optional command gives a name, which may be up 
to ten characters long, to the character set 
currently selected for loading. This name is used 
for reporting the current character set (see 
Reports) . Both <name> and <integer> (above) may be 
specified in the same option, but if <name> is 
specified first, it will be associated with the 
currently selected set, not necessarily the one 
specified by <integer>. 

Load Character Cell 

Format: L"<ascii char>" <hex pair> , . . . , <hex pair>; 

A character set is 95 cells, with each cell 
identified by one ASCII printing character in 
<ascii char> enclosed in double ("") or single ('') 
quotes. However, if more than one character is in 
<ascii char>, only the first character is used and 
the rest of the characters are ignored. 

Each character cell is ten pixels high and eight 
pixels wide. It is defined by the locations of 
bits in a series of ten eight-bit bytes that are 
transmitted as hexadecimal digit pairs separated by 
commas. You can load other character cells in the 
set in the same L command by putting the quoted 
character immediately after the last <hex pair> of 
the previous character cell. A semicolon 
terminates the complete Load command. Figure 5-31 
shows a sample cell and its construction. 

I's represent light (foreground) pixels in usual 
(non-reversed) writing. The default width for 
displayed characters using the S<integer> Text 
command is 9 pixels. The ninth pixel is copied 
from the first pixel. If you want a dark space 
between characters, you must either use only the 
right seven bits in each row (like the permanent 
ASCII character set) , or use the explicit text size 
and spacing commands. 

Cells are always loaded one row at a time using 
hexadecimal ascii digits for the character 
specifiers. A cell is specified from the top down, 
with the most significant bits in the left digit of 
the specifier. If more than two digits are given 
for a single line of the character specifier, the 
digits on the left are ignored. If only a single 
digit is specified, it fills the low order portion 
of the character map line specifier, setting the 
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1111 


1111 




FF 


• • • • 


10 1 


10 1 




99 
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10 10 


10 1 
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• • • • 
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10 1 




99 


• • • • 


10 1 

1111 


10 1 

1111 




99 
FF 


FORMAT: L"a"FF,99,A5,C3,C3,A5,99,99,99,FF 
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Figure 5-31 Sample Character 
Cells 
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Table 5-18 Character Set Definition Format 



L( A<integer> "<name>") "ascii character" 

<hex digit>,<hex digi t>, . . . ,<hex digit> "ascii 
character" <hex dig it> , . . . ,<hex digit>; 



Table 5-19 Character Cell Control Summary 

L { (A<integer>) } Select for loading 

{ } 

{ (A"<name>") } Give name to set 

{ } 

{ "<ascii char>" <hex pair> , . . . ,<hex pair>; } Load cell 



high order part to zero. If less than ten 
specifier lines are given, the unspecified portion 
of the cell is cleared to zero. 

Table 5-18 shows the format for a complete 
character set definition. 

Table 5-19 is a summary of the Character Cell controls. 

REPORTS 

The report command causes the graphics processor to send 
information through the requesting channel. There are three types 
of reports. 

If multiple reports are requested in a single report command or 

report command option, each separate report requested is sent as 

if it was the only report requested. Every report sent is ended 
with a carriage return. 




- .--- I -E- ^--. „-^„-,^„r,.. ^^r-— - ■ - -" '--'y long 

(more than 40 - 50 characters) and is echoed back to the terminal 
may cause the terminal to hang in a deadlock situation: The 
terminal refuses (using XOFF) to accept characters echoed until 
the report is complete. If the host cannot accept the remainder 
of the report without echoing it, then the deadlock occurs. 

Report Character Set Selected for Loading 

Format: R(L) 

The character set name is reported back in the same 
form as the option specifier that defined it, for 
example, (A"Greek"). 
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Report Contents of a Macrograph 
Format: R (M(<keyletter>) ) 



The macrograph with name <keyletter> is reported 
back headed by a macrograph report indicator 
"§=<keyletter> " and followed by a macrograph 
terminator "§;" followed by a carriage return. Any 
control characters that were saved as part of the 
macrograph are also reported back. If there is no 
macrograph defined for the keyletter, a null 
macrograph is reported back (no characters), 
enclosed in the indicator and terminator. include 
more keyletters in the inner parenthesis for more 
reports. The macrograph report indicator format is 
ignored if echoed back to the terminal. 



Report Use of Macrograph Storage 

Format: R(M{=)) 



With an equal sign " = " in the command, the report 
lists the status of macrograph storage in the form: 

"<f ree>,<total>" 

where <free> is the number of characters still 
available for macrograph storage and <total> is the 
total number of characters of macrograph storage 
provided in the graphics processor memory. Storage 
in use may be calculated by subtracting <free> from 
<total>. The report is ended with a carriage 
return. 



Report Cursor Position 

Format: R(P) 

Report the current cursor position in user 
coordinates as set by Define Display Addressing. 

The cursor position is reported as a pair of 
unsigned numbers, X-value first, enclosed in square 
brackets . 

Table 5-20 is a summary of the Report command. 
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Table 5-20 Report Command Summary 



R { (L) 

(M(<keyletter>) 
(M( = )) 

"<free>,<total>" 
(P) 



Set selected for loading 
Contents of macrograph 
Use of storage 
Reply to Use 
Cursor position 
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CHAPTER 6 
VT105 EMULATION 



6.1 INTRODUCTION 

The VT105 function set is described in this chapter. It is the 
same as the VT105 as described in the VT105 User Guide with the 
following exceptions. 

1. The control sequence to enter VT105 mode is not ESC 1, 
but ESC P t (DCS format) . The sequence to exit VT105 mode 
is not ESC 2, but ESC \ (ST) . 

2. Only one VT105 emulator can exist in a VT125. Accesses to 
a second waveform generator board (an optional 
configuration in the VT105) through command characters P, 
Q, R, S, T, X, Y, Z [, and \ are ignored. 

3. The relative positions of the graphics and text display 
fields are not exactly the same as in the VT105. There 
are always at least 6 VT100 character positions to the 
left of the left graphics margin, and the width of the 
graphics field with respect to the 80 character VT100 
text field may be off by one or two characters. 

4. The resolution of the VT105 is mapped into the VT125 
display using non-uniform dot spacing. Therefore, there 
may be some small scale differences visible in some graph 
presentations. 

5. The VT105 interactive graphics test does not exist in the 
VT125 emulation. The hardware is tested by the VT125 
tests. 

6. Some actions performed by dedicated hardware in the VT105 
(blank, reset, and shade, for example) will take longer 
to execute in the VT125, and may cause a slight 
difference in performance between the machines. 

NOTE; The state of the VT125 cannot be guaranteed if you 
switch between protocols. For example, while it may ""5e 
possible to use ReGIS to add to a VT105 presentation, you 
cannot be sure that either protocol will be where you 
left it when you switch between them. This is different 
from switching between ReGIS and text mode, where ReGIS 
stays in the same state until you return. 
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This chapter describes how to: 

Select the graph drawing mode 

Establish the graph area 

Establish desired display 

Load graph data 

Generate shade lines, cursors, and grid 

Enter strip chart data 

6.2 ENTERING THE GRAPH DRAWING MODE 

ESC P t (033 120 164) switches the terminal to VT105 graph drawing 
mode. The terminal will remain in this mode until ESC \ (033 134) 
is received. 
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GRAPH: 



DEFINITIONS AND LIMITATIONS 



GRAPH MARKER; 



HISTOGRAM: 
(SHADED GRAPH) 



SHADE LINE; 
(BASELINE) 



HORIZONTAL LINES/ 
VERTICAL LINES: 



STRIP CAHRT: 



A graph is a series of points representing the 
variation in value of two variables: X and Y. 
each horizontal value(x), there can be 
/ nno Y value; example, a sine wave. 



For 
only 



one 



short vertical line that 



A graph marker is a short vertical line that 
may be programmed to mark any point of the 
graph. Each marker represents a specific value 
of X and appears at intervals of Y = 240/16. 
As many as 512 markers can be placed on each 
graph or histogram for a total of 1024 
markers. See Figure 6-1. 

A histogram in the VT105 is a graphic display 
that has the area between the graph line and 
the bottom of the graph drawing field 
intensified. Two histograms can overlap and 
still be discernible. A bar graph is an 
example of a histogram, as shown in Figure 
6-2. 

A shade line (baseline) is the line referenced 
for shading a graph. One shade line can be 
displayed for each of the two graphs. If no 
shade line is established, the graph can be 
shaded to the bottom of the graph drawing 
area. (See Histogram.) 

Horizontal lines and/or vertical lines may be 
displayed in the graph area to represent set 
values of X or Y. As many as 512 vertical or 
240 horizontal lines may be individually 
displayed on the screen. For example, a grid 
is displayed using specific values for 
horizontal and vertical lines, as shown in 
Figure 6-3. 

A strip chart is a graph or histogram that 
permits new data to be added to its right side 
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Figure 6-1 Graph with Graph Markers 




Figure 6-2 Histogram Display (Shaded Graph) 
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Figure 6-3 Example of a Grid Display 
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DUAL STRIP CHART: 



RECTANGULAR GRAPH 
DRAWING FIELD: 



SQUARE GRAPH 
DRAWING FIELD: 



GRAPH RESOLUTION: 



while shifting previous data to the left, as 
in Figure 6-4. Vertical and horizontal lines, 
if present, move from right to left as the 
strip chart moves, and wrap around the screen 
as they leave the left edge. 

Dual strip chart is a feature that allows both 
Graph and Graph 1 to pass across the screen. 

The rectangular graph drawing field is one of 
two aspect ratios selectable within the VT105. 
It has a 20 X 10.9 cm (8 X 4-3/8 in) graph 
drawing field compatible with previous DIGITAL 
graph drawing terminals (e.g., VT55) . See 
Figure 6-5. 

The square graph drawing field is a selectable 
aspect ratio with a 16.5 X 11-5 cm (6.5 X 4.6 
in) graph drawing field. It compresses the 
X-axis length and provides a greater area 
outside the field for alphanumeric labels, 
grid identifiers, or notes. See Figure 6-6. 

Up to 512 horizontal and 230 vertical points 

may be displayed per graph in the rectangular 

graph drawing field; 512 X 240 points, in the 

square graph drawing field. 

6.4 SELECTING THE GRAPH DRAWING FIELD 

The VT105 has two selectable graph drawing fields or formats. Both 
formats display up to two 512-point graphs having single valued 
functions of X. Either or both graphs can be displayed as a 
histogram or a strip chart. Graphs and histograms can overlap and 
still be discernible, allowing the use of the entire field for 
both graphs, both histograms, or a graph and a histogram displayed 
together. Both formats display individually programmable 
horizontal and vertical lines over the entire graph field allowing 
a grid to represnt any desired value. Graph markers can be 
displayed in either format. Table 6-1 compares the formats and how 
each is selected. 

Example: 

2r Octal Code 

Field 

Enable square format 
Enable rectangular format 

6.5 SELECTING DESIRED DISPLAY 

Enabling graphs, histograms, strip charts, and shade lines 
(baselines) is accomplished by loading control register in the 
Vtl05; enabling graph markers, vertical lines, and horizontal 
lines is accomplished by loading control register 1. The registers 
are loaded by sending a two or three character sequence from the 



Character 




Octal Code 


Sequence 




Sequence 


I space! 




111 040 041 


I space spa 


ce 


111 040 040 
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Figure 6-4 Strip Chart Display 

(Moves From Right to Left) 



(Xo, Y22910) 
1- 



10.9 CM 

(4 3/8 IN) 



230 DOTS 



-512 DOTS- 



20.32 CM_ 

(SIN) 



(X51110. Y229iot 



(X51I10. Yo) 



Figure 6-5 Rectangular Graph Drawing 
Field 
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IXo, Y239I 



EIGHT 
CHARACTERS 



240 DOTS 



-480 DOTS- 



-512 DOTS- 



J5.2CM_ 
(6 IN) 
16.5 CM_ 
(6.5 IN) 



(X511,Y239) 



(X51I, YQ) 



11.5 CM 

(4 5/8 IN) 



7 CHARACTERS 



Figure 6-6 Square Graph Drawing Field 
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Table 6-1 Comparison of Graph Drawing Formats 



Rectangular Square 
Feature Format Format 



Graph Field 20 X 10.9 cm* 16.5 X 11.56 cm 

(maximum) (8 X 4.3 in) (6.5 X 4.625 in) 

Graph Resolution 512 X 230 512 X 240 

(maximum) points points 

Features 

Graphs 2 2 

Shaded Graphs 2 2 

Movable Shade lines 1 per graph 1 per graph 

Strip Charts 2 2 

Vertical Lines 512 512 

Horizontal Lines 230 240 

Graph Markers 512 per graph 512 per graph 

Space provided in l character 8 characters 

left margin for: (column 1) (columns 1 — 8) 



* 



Character lines i line 

below graph field: (line 24) 

Selected on Initialize Yes 



none 



No 



Program selectable by: I space space I space! 

Display using previous Display Both height 

DECgraphic software unchanged and width are 

(i.e., VT55) changed 

NOTE; These dimensions come from the VT105 specification and are 
slightly different in the VT125 emulation. Use them for comparison 
of the formats only. ~ 



keyboard or host computer. The number of characters depends on the 
type of graph or shade line (baseline) desired. The control bits 
are encoded as 7-bit ASCII characters that are sent to the 
terminal . 

6.5.1 Loading Control Register 

To determine the required bits to set in register 0, refer to 
Table 6-2. A seven digit binary code transmits the desired 
display. The bits are set as desired, for example: Bit 2 is set to 
enable Graph 1: bit is set to enable the display. The binary 
code created is 0100101 (045_) . For examples of loading register 
0, see Table 6-3 and Table 6-4. 
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Table 6-2 Load Enable Register Command 



Rectangular or 
Square Format 

1st character: A (101q) 

2nd character: variable (See below) 

3rd character: variable (See below) 

Explanation : 

The second character is formed by setting bits where the bits have 
the following functions: 



Bit 
6 
5 
4 



2 

1 




2nd Character (Register 0) 



Always 0. 
Always 1. 



If 1, displays graph 1 as a shaded graph 
to the bottom of the graph field 
(Histogram 1 ) . 

If 1, displays Graph as a shaded graph 
to the bottom of the graph field 
(Histogram 0) . 



If 1, displays Graph 1. 
If 1, displays Graph 0. 



If 1, enables all graphic information 
to be displayed. "^ 



Binary Code 
1 X X X X X 



NOTES: ^. , , 

1. Enabling graph and histogram (or graph 1 and histogram 1) 
at the same time intensifies the graph envelope. 

2. Enabling Shade Line (or Shade Line 1) automatically shades 
Graph (or Graph 1); Histogram (bit 3) and Histogram 1 (bit 4) 
do not need to be enabled when shade lines are used. 
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Table 6-2 Load Enable Register Command (Cont) 

3rd Character (Register 0) 



Bit 
6 

5 

4 



Always 
Always 1 



If 1, allows Graph and 1 data to be 
shifted from right to left (dual strip- 
chart feature) . 

If 1, allows Graph or 1 data to be 

shifted from right to left (single 

strip chart enabled). 



If 1, displays Graph 1 as a shaded 
graph, referenced to Shade Line 1. 



If 1, displays Graph referenced to 
Shade Line 0. 



Binary Code 
C 1 X X X X X 



If 0, allows Shade Line data to be 
loaded by the second word of the @ 

instruction: if 1, allows Shade Line 1 — ^ 

data to be loaded by the second word 
of the @ instruction. 

NOTE; B it 3 enables the single strip chart feature; either Graph 
or Graph 1 data, but not both, can b e incremented from right to 
left. 

Bit 4 enables the dual strip chart feature. With Graph enabled. 
Graph data is entered, but the data does not shift at this time. 
Graph 1 IS enabled and Graph 1 data is entered, then both Graph 
and Graph 1 will shift their data one increment to the left. 
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Table 6-3 Examples of Selecting Graphs or Histogram 











Binary 




Function 


Character 


Octal 


Code 


Code of 


Decimal 


Enabled 


Sequence* 


Sequence 


2nd Character 


Value 


Graph 


A# 


101 


043 


0100011 


35 


Graph 1 


A% 


101 


045 


0100101 


37 


Graphs and 1 


A • 


101 


047 


0100111 


39 


Histogram 


A) 


101 


051 


0101001 


41 


Histogram 1 


Al 


101 


061 


0110001 


49 


Histograms 












and 1 


A9 


101 


071 


0111001 


57 


Graph and 












Histogram 1 


A3 


101 


063 


0110011 


51 


Graph 1 and 












Histogram 


A- 


101 


055 


0101101 


45 


Disable graphs 












and histograms 


A space 


101 


040 


0100000 


32 



* A third character is used to enable (or disable) shaded graphs 
(referenced to a shade line) and to enable strip charts. See 
Table 6-4. 



Table 6-4 Examples of Selecting Shaded Graphs with Shade Lines 
(Baselines) and Strip Charts 



Function Enabled 



Third 


Octal 


Binary 


Decimal 


Character 


Code 


Code 


Value 


II 


042 


0100010 


34 


% 


045 


0100101 


37 


& 


046 


0100110 


38 


( 


050 


0101000 


40 


) 


052 


0101010 


42 





060 


0110000 


48 



Load Shade Line 0* 
Load Shade Line 1* 
Enable Shaded Graphs with 

Shade Line and 1 
Enable single strip chart 
Enable strip chart with shaded 

Graph and Shade Line 
Dual strip chart 
Dual strip chart with shaded 

graphs and shade lines 



066 



0110110 54 



* Loading or moving the shade line 
not affect Graph or Graph 1 
loading shade line position. 



(base line) 
data. See 



in the VT105 does 
Paragraph 6.7 for 
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Table 6-5 Graph Drawing Characters 



Octal Decimal 

Character Code Binary Code Value 



SPACE 


040 


0100 


000 


32 


! 


041 


0100 


001 


33 


II 


042 


0100 


010 


34 


# 


043 


0100 


011 


35 


$ 


044 


0100 


100 


36 


% 


045 


0100 


101 


37 


& 


046 


0100 


110 


38 


' (apostrophe) 


047 


0100 


111 


39 


( 


050 


0101 


000 


40 


) 


051 


0101 


001 


41 


* 


052 


0101 


010 


42 


+ 


053 


0101 


011 


43 


' (comma) 


054 


0101 


100 


44 


- (minus) 


055 


0101 


101 


45 




056 


0101 


110 


46 


/ 


057 


0101 


111 


47 





060 


0110 


000 


48 


1 


061 


0110 


001 


49 


2 


062 


0110 


010 


50 


3 


063 


0110 


011 


51 


4 


064 


0110 


100 


52 


5 


065 


0110 


101 


53 


6 


066 


0110 


110 


54 


7 


067 


0110 


111 


55 


8 


070 


0111 


000 


56 


9 


071 


0111 


001 


57 


• 
• 


072 


0111 


010 


58 


• 


073 


0111 


011 


59 


< 


074 


0111 


100 


60 


= 


075 


0111 


101 


61 


> 


076 


0111 


110 


62 


7 


077 


0111 


111 


63 



Table 6-5 can be used to convert the binary codes created for 
register to the program requirements. 

Example: 

Octal 
Function Code Character Code 

Enable Graph 1 045 % 0100101 
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6.5.2 Enabling Graphs and Histograms (Shaded Graphs) 

The second character in a sequence for loading register selects 
the graph or histogram to be displayed. The letter a (101g) allows 
register to be loaded. 

6.5.3 Enabling strip Charts and Shade Lines (Baselines) 

The third character in the load register sequence enables shaded 
graphs and strip charts. Some of the common functions enabled by 
the third character are listed in Table 6-4. 

6.5.4 Loading Control Register 1 

the characters required to enable graph markers and grid lines are 
formed by setting the appropriate bits in the diagrams in Table 
6-6, then finding the character for the code created in Table 6-5. 



Table 6-6 Load Enable Register 1 Command 



1st character: I (Hip) 73, „ 

2nd character: variable (see below) 

3rd character: variable (see below) 



2nd Character (Register 1) 



Bit 
6 

5 
4 



Binary Code 
1 X X X X X 



The most significant bit is always 0. — 

Always 1 . ~" 

If 1, clears the static RAMs containing 
any vertical lines, horizontal lines. 
Graph 0, Graph 1, and any graph markers, 
It does not clear the load enable 
register — Register and Register 1. 



If 1, allows Graph 1 markers to be 
displayed. 



If 1, allows Graph markers to be 
displayed . 

If 1, allows vertical lines to be 
displayed. 



If 1, allows horizontal lines to be 
displayed. 
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Table 6-6 Load Enable Register 1 Command (Cont) 

3rd Character (Register 1) 



Bit 



Always 0." 
Always 1 . 



2 — 4 (unused) 



If 1, enable Interactive Graphic Test 
(Not available in VT125 emulation) 



If 0, the rectangular graph drawing 
field is selected; if 1, the square 
field is selected. The rectangular 
field is also enabled by an initialize 
signal (INIT) during power-up. 



Binary Code 
1 X X X X X 



6.5.5 Enabling Graph Markers, Vertical Lines, and Horizontal 
Lines 

Turning graph markers and grid lines ON and OFF is accomplished by 
loading register 1. The character sequence is the same in either 
graph drawing format, except a third character establishes the 
desired format. The exclamation mark, !(041p), enables the square 



format; a SPACE (040g) enables the rectangular format. The 
rectangular format is enabled also on initializing the terminal. 

Table 6-7 shows examples of enabling graph markers, horizontal 
lines, and vertical lines. 

6.6 FORMING GRAPH DRAWING DATA CHARACTERS 

In order to represent a horizontal or vertical address of a point 

on a 240 X 512 point graph, at least 9 binary bit positions are 

required. 

Examples: 239,^ = 011101111„ 



511 



10 
10 



= lllllllli: 



Keys typed from the keyboard, or transmitted from the host 
computer, normally only contain 7 digits (7-bit ASCII characters). 
Therefore, two keys must be typed, or two codes transmitted, to 
fully describe an X or a Y value. The first key (character) 
transmits the lower five bits of the binary data value: the second 
key transmits the remaining bits, or upper data value. 
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Table 6-7 Examples of Selecting Graph Markers, Horizontal Lines, 
and Vertical Lines 

NOTE: Remember to bit map all options correctly when sending out a 
command. Setting a desired feature may reset other features if all 
options are not considered. 

Binary 
Character Octal Sequence* Code of Decii 
Function Enabled Sequence 1st 2nd 2nd Char. Valu( 

Clear graph drawing 10 111 060 0110000 48 

memories 
Enable horizontal I# 111 043 0100011 35 

and vertical lines 
Enable horizontal I! ill 041 0100001 33 

lines only 
Enable vertical I" 111 042 0100010 34 

lines only 
Enable Graph I$ ill 044 0101100 36 

markers 
Enable Graph 1 l( ill 050 0101000 40 

markers 
Enable Graph and I, 111 054 0101100 44 

1 markers 
Enable grid and Graph I' 111 047 0100111 39 

markers 

Enable grid and Graph 1+ 111 053 0101011 43 

1 markers 

Enable grid and Graph 1/ 111 057 0101111 47 

and 1 markers 
Disable lines and I space 111 040 0100000 32 

graph markers 

* A third character is required to establish the square format, to 
change formats, or to set up the Interactive Graphics Test. 

To load coordiantes for the function enabled by register 1, refer 
to the following paragraphs. 

Function Paragraph 

Load graph markers 6.10 
Load vertical lines 6.11 
Load horizontal lines 6.12 
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The graph drawing data characters can be standardized to the 32 
characters listed in Table 6-8 if bits 5 and 6 of each character 
are always 1 and 0, respectively, as in the following format: 



01XXXXX 



bit 6 

bit 5 

bits 0-4 



The data value is then transmitted in two parts as in the diagram 
below: 

Data to be Transmitted 



XXXXXXXXX 



1st data character 
2nd data character 



' r 

^01XXXXX 

J-. 1 1 1 1 1 

01XXXXXI I I I I 

1 1 1 1 1 1 1 1 1 

XXXXXXXXX 

Received Value 

6.6.1 Selecting Upper and Lower Data Characters 

The value of the lower data ranges from to 31, „; the upper data 
value increases in increments of 32 decimal units. Together they 
can describe any value of the graph drawing field. To find the 
characters or code to transmit a desired location, perform the 
following . 



1. Select the upper data value closest, 
the desired value in Table 6-8. This 
character which is transmitted last. 



but not exceeding, 
is the second data 



Example: 



Value 
To be 
Transmitted 

200. 



Nearest 
Upper 
Data 
Value 

192. 



Second 

Data 

Character 



Binary 
Code 

0100110. 



Octal 
Code 

046, 



'10 -^-^^10 i.x..,c.xx«2 "^^s 

NOTE: If a horizontal line, vertical line, or graph marker is to 
be loaded, use values in the lower half of the upper data column; 



I.e. 



192 



10- 



is 066 q or the character 6. 
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Table 6-8 Graph Drawing Data Characters 



Decimal 


Data 


Value 








Lower data 


Upper 


data 


Binary 


Octal 


Data 


1st data 


2nd data 


Code 


Code 


Character 




Load 


shade 










line 


(base- 










line) 


and 










graph 


data; 










erase 


other 










lines 


• 
















0100000 


040 


SPACE 


1 


32 




0100001 


041 


1 

• 


2 


64 




0100010 


042 


II 


3 


96 




0100011 


043 


# 


4 


128 




0100100 


044 


$ 


5 


160 




0100101 


045 


% 


6 


192 




0100110 


046 


& 


7 


224 




0100111 


047 


' (apostrophe) 


8 


256 




0101000 


050 


( 


9 


288 




0101001 


051 


) 


10 


320 




0101010 


052 


* 


11 


352 




0101011 


053 


+ 


12 


384 




0101100 


054 


, (comma) 


13 


416 




0101101 


055 


- (minus) 


14 


448 




0101110 


056 


• 


15 


480 
Load 


Horizontal , 


0101111 


057 


/ 




vertical lines. 










and markers* 








16 







0110000 


060 





17 


32 




0110001 


061 


1 


18 


64 




0110010 


062 


2 


19 


96 




0110011 


063 


3 


20 


128 




0110100 


064 


4 


21 


160 




0110101 


065 


5 


22 


192 




0110110 


066 


6 


23 


224 




0110111 


067 


7 


24 


256 




0111000 


070 


8 


25 


288 




0111001 


071 


9 


26 


320 




0111010 


072 


• 


27 


352 




0111011 


073 


• 


28 


384 




0111100 


074 


< 


29 


416 




0111101 


075 


= 


30 


448 




0111110 


076 


> 


31 


480 




0111111 


077 


7 



* Upper data values below this line are used for loading graph 
markers and horizontal or vertical lines; they require bit 4=1. 
To erase these lines, or load shade lines (baselines), graph 
data or starting X-coordinate , use values above this line. 
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Table 6-9 Load Data Sequences 



Function 



Load shade 
Load Graph 
Load Graph 
Load Graph 
Load Graph 
Load 
Load 



line (baseline) 

data 

1 data 

marker 

1 marker 
horizontal line 
vertical line 



Load starting X-coordinate 



Load 
Character 



Character 
Sequence 



@ 
B 
J 
C 
K 
D 
L 
H 



Range 



§ 1st data 2nd data — 239 

B 1st data 2nd data — 239 

J 1st data 2nd data — 239 

C 1st data 2nd data — 511 

K 1st data 2nd data — 511 

D 1st data 2nd data — 239 

L 1st data 2nd data — 511 

H 1st data 2nd data — 511 



2. Find the remainder of the value 
lower data value column. This 
character transmitted. 



to be transmitted in the 
will be the first data 



Example ; 



Remaining 
Value 



Lower 

Data 

Value 



First 

Data 

Character 



Binary 
Code 



Octal 
Code 



8 



8 



( 



0101000. 



050 



8 



6.6.2 Load Data Sequences 

The data to be transmitted is initially preceded by a "load 
character," as described in Table 6-9. In the above example, 
loading a shade line at line 200, „ is transmitted by @(& or 
equivalent program. Storing a horizontal line at line 200, „ is 
transmitted by D(6 or equivalent program. 



10 



For multiple data entries, the load character does not need to be 
repeated. This allows data for a graph to be loaded into memory 
without repeating the character B or J. Exceptions to this 
procedure are loading a shade line and loading the starting 
X-coordinate . 

6.6.3 Frequent Data Entry Errors 

Largest Data Character Transmitted First — The low-order bits of 
the data value (lower data value in Table 6-8) must be transmitted 
first; if reversed, the point will typically exceed the range 
limits of the graph drawing field and not be displayed, or, it may 
appear near the edge of the field. 



Example: 










Desired 


Data 


Characters 


Characters 


New 


Shade line 


Transmitted 


Should be 


Reversed 


Values 


40 


8 + 32 


@(! 


@! ( 


1 + 256 


70 


6 + 64 


@&" 


@"& 


2 + 192 
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Table 6-10 Loading Shade Line Position 



Previous 
VT55 Format 



New VT105 Format 
Load Shade Line 



1st character: 
2nd character: 
3rd character: 

NOTE: Shade Line 



@ NOP 

none 

none 






@ (100.) 

01XXXXX 

01XXXXX 


or Shade 


Line 


1 is Ic 



64 



10 



is loaded depending on which 



shade line is selected by loading register 0. See paragraph 6.5.3. 



Zero Valued Characters Not Transmitted — When transmitting data 
with two characters, if the upper data value is equal to the point 
or line desired, a SPACE (040g) (equal to zero) must be the first 
data character. If missed, the line or point will be much less 
than desired. 



Example : 

Shade line 
Desired 

160 



Data 
Required 

+ 160 



Characters 
Should be 

@ SPACE % 



Characters 
In error 



Wrong 
Value 



6.7 LOADING THE SHADE LINE (BASELINE) 

A movable shade line can be displayed for both Graph and Graph 
1. One shade line canb e entered for Graph 0, and one for Graph 1, 
on any of the 230 (or 240, square format) horizontal lines 
available. To transmit positions within this range, a load 
character and two data characters are used, as shown in Table 
6-10. Positions can be created by following Paragraph 6.6 for 
forming graph drawing data characters. 

6.8 LOADING GRAPH MEMORIES 

The M7071 has two graph memories -- Graph and Graph 1. Each 
graph may plot up to 512-hor izontal points. Each horizontal point 
may have only one value using up to 230 vertical points with the 
rectangular format (or 240 vertical points with the square 
format). The graph will begin entering data at X = (040p) unles 
a starting X-address is specified. (See Paragraph 6.13.) 



The data to be entered is initially preceded by the letter B 
(102g) for Graph 0, or J (112g) for Graph 1. Each pair of data 
characters describes a Y-data point. 

A Y-value is entered for each value of X, using two data 
characters, as described in Paragraph 6.6. As the X-address is 
incremented from to 511, the values of Y can sequentially be 
loaded into memory. The X-register will automatically increment 
after each pair of Y-data characters are stored in memory, except 
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Table 6-11 Loading Graph Data 



Graph 



Graph 1 



1st character: 
2nd character: 
3rd character: 



B (102 ) 

variable (see below) 

variable (see below) 



J (112 ) 
variable 
variable 



Explanation of Second Character: 

Bit 

6 The most significant bit is always 0.- 

5 Always 1.- 



— 4 The remaining bits form the low-order 
5 bits of an 8-bit Y-value. 

Explanation of Third Character: 



Bit 
6 

5 
4 
3 
0—2 



The most significant bit is always 0- 

Always 1. 

(unused) — .. — — _ 

(unused) " ' — — 



The remaining bits form the high-order 
3 bits of the 8-bit Y-value. 



Binary Code 







X X X X X 



Binary Code 

1 X X X X X 
I 



when dual strip charts are enabled. (See paragraph 6.14.) The 
letters B or J do not need to be repeated for each pair of Y-data 
characters. Table 6-8 may be used to determine the Y-data 
characters . 

transmitted first, then the upper data value. 

The formation of graph data characters is illustrated in Table 
6-11. 
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Figure 6-7 



Histogram without Shade Line 
(Baseline) Enabled 




Mn-3517 
MA-9455 



Figure 6-8 Graph with Shade Line 
(Baseline) Enabled 
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6.9 HISTOGRAM DATA 

Data for a histogram (shaded graph) is entered by loading the 
appropriate graph memory (Paragraph 6.8). Histogram and/or 
Histogram 1 is enabled by loading register 1 (Paragraph 6.5). 
Enabling a histogram will shade points between the graph envelope 
and the bottom of the graph field. Shading occurs from the graph 
data to graphline (Figure 6-7) . With a shade line (baseline) 
enabled, the graph is shaded above and below this line, as in 
Figure 6-8. 



6.10 LOADING GRAPH MARKER MEMORY 

A graph marker is a short vertical line which marks the graph line 
a desired value of X. A graph marker can be programmed for any 



at 



point on Graph and on Graph 1. As many as 512 graph markers can 
be placed on each graph. 



Loading graph marker memory is accomplished by sending pairs of 
data characters following the letter C (103g) for Graph 0, or K 
(113g) for Graph 1. Each pair of data characters represents the 
lower data value and the upper data value of an X-address, as 
illustrated in Table 6-12. Note that bit 4 of the third character 
determines whether the graph marker will be loaded or erased. 

Example: 



Function 

Load graph marker 
at location 100 



Erase graph 

marker at location 100 



Binary 


Octal 


Character 


Code 


Code 


Sequence 


1000110 


106 




0100100 


044 


C$3 


0110011 


063 




1000110 


106 




0100100 


044 


C$# 


0100011 


043 





Table 6-8 may be used to determine the characters required to load 
or erase a specific graph marker. Once stored in memory, graph 
markers are enabled and disabled by loading register 1. (See 
Paragraph 6.5.4.) 

6.11 DISPLAYING VERTICAL LINES 

Vertical lines may be programmed for any of the 512 points along 
the X-axis. Vertical lines are loaded following the letter L 
(114g) . The second and third characters form an X-data value, as 
Illustrated in Table 6-13. Note that bit 4 of the third character 
must equal a 1 for the line to be loaded; a in bit 4 will erase 
that line. Table 6-8 may be used to determine the characters 
required to load or erase a specific line. Vertical lines are 
enabled and disabled by loading register 1. (See Paragraph 6.5.4.) 
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Table 6-12 Load Graph Marker Memory 



Graph 
Marker 



Graph 1 
Marker 



1st character: 
2nd character: 
3rd character: 



C (103 ) K (113g) 
variable variable 
variable variable 



Explanation of Second Character 



Bit 
6 

5 

0--4 



The most significant bit is always 0. 
Always 1. — ~" - 



The remaining bits form the low-order_ 
5 bits of a 9-bit X-address. 



Explanation of Third Character 



Bit 
6 
5 
4 

— 3 



The most significant bit is always 
Always 1. 



If 1, causes graph marker to be loaded; 
if 0, causes marker to be erased. 



The remaining bits form the high-order^ 
4 bits of the 9-bit X-address. 



Binary Code 
1 X X X X X 



Binary Code 
1 X X X X X 
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Table 6-13 Load Vertical Line Coordinate 



1st character: L (114g) 

2nd character: variable (see below) 

3rd character: variable (see below) 

Explanation of Second Character: 



Binary Code 
1 X X X X X 



Bit 
6 
5 
— 4 



The most significant bit is always 0.- 
Always 1 . — 

The remaining bits from the low-order 
5 bits of a 9-bit X-position. 



Explanation of Third Character; 



Bit 
6 
5 
4 

— 3 



Binary Code 
1 X X X X X 



The most significant bit is always 0. 
Always 1 . — — 



If 1, causes vertical line to be loaded;_ 
if 0, causes vertical line to be erased. 



The remaining bits form the high-order 
4 bits of a 9-bit X-position. 



6.12 DISPLAYING HORIZONTAL LINES 

A horizontal line is loaded into memory by two data characters 
following the letter d (104 ) . The second and third characters 
from a Y-data value, as ilfustrated in Table 6-14. Up to 230 
horizontal lines may be displayed in the rectangular format; 240, 
m the square format. Note that bit 4 in the third character must 
equal a 1 to load a horizontal line; bit 4=0 will erase the line. 
Table 6-8 can be used to determine the characters required to load 
or erase a specific horizontal line. Horizontal lines are enabled 
and disabled by loading register 1. (See Paragraph 6.5.4.) 
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Table 6-14 Load Horizontal Line Coordinates 



1st character: D (104g) 

2nd character: variable (see below) 

3rd character: variable (see below) 

Explanation of Second Character: 



Bit 

6 

5 



The most significant bit is always 0, 
Always 1 .— 



— 4 The remaining bits from the low-order 
5 bits of a 8-bit Y-position. 

Explanation of Third Character: 



Bit 
6 
5 
4 

3 

— 2 



The most significant bit is always 0, 
Always 1 



If 1, causes horizontal line to be loaded; 
if 0, causes horizontal line to be erased. - 



Unused. 



The remaining bits form the 3 high-order_ 
bits of a 8-bit Y-position. 



Binary Code 
1 X X X X X 



Binary Code 
1 X X X X X 



6.13 LOAD THE STARTING X-COORDINATE 

A starting X-coordinate may be loaded by two data characters 
following the letter H (1100) , as illustrated in Table 6.15. Any 
value of X, from to 511, may be used. The data characters 
required for the desired X starting address can be determined from 
Table 6-8. 

NOTE: The lower data value of X must be transmitted first, then 
the upper data value. 

6.14 ENTERING STRIP CHART DATA 
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Table 6-15 Load Starting X Coordinate 

1st character: H (110g) 

2nd character: variable (see below) 

3rd character: variable (see below) 

Elplanation of Second Character: 



Bit 
6 

5 
— 4 



The most significant bit is always 0. 
Always 1.— 



The remaining bits from the low-order 
5 bits of a 9-bit X-position. 



Explanation of Third Character: 



Binary Code 
1 X X X X X 



Bit 

6 

5 

4 

0--3 



Binary Code 
1 X X X X X 



The most significant bit is always 0.- 

Always 1 . — — — 

Unused 



The remaining bits form the high-order_ 
4 bits of a 9-bit X-position. 



6.14.1 Single Strip Chart Data 

Data for a single strip chart is entered by loading either Graph 

or Graph 1 memory. 

1. Enable the desired graph and single strip chart feature 
by loading register 0. (See Table 6-2.) 

Example: 

Enable Graph 0, Single Strip Chart, and Shade Line 0. 
Enter : 



Character 
Sequence 

A#* 



Octal 
Sequence 

101g 043g 052g 



Decimal 
Sequence 



^^10 3^10 ^2i0 
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2. If desirable, load the starting X-coordinate at the right 
margin. Enter: 

H?? 1108 0773 0778 "72^0 ^^10 ^^10 

3. Now, enter data into Graph memory; type B plus any 
sequence of two data characters. If started at the right 
margin, this will cause the graph to move from right to 
left; if not, the graph will fill the screen first, then 
move data from right to left with each new data word. 

B(data) (data) 102g (data) (data) SG-j^g (data) (data) 

6.14.2 Dual Strip Chart Data 

To set up the dual strip chart feature: 

1. Enable both graphs and the dual strip chart feature; set 
bit 4 of the 3rd character in register 0. (See Table 
6-2.) 

Example: 

Load Graph and 1, dual strip chart, and Shade Line 

and 1. Enter: 

Character Octal Decimal 

Sequence Sequence Sequence 

A -6 1013 0473 0663 65^0 39^0 54^0 

H?? 1108 0773 0773 72^0 63^0 63^0 

3. Enter Graph data; enter a B and two data characters. 
(The data is entered, but the graph will not move at this 
time. ) 

B(data) (data) 102g (data) (data) 663^0 (data) (data) 

4. Enter Graph 1 data; enter a J plus two data characters. 
The graph will now display and shift both Graph and 
Graph 1 data points one increment to the left. 

J(data) (data) 112g (data) (data) 74^g) (data) (data) 

NOTES; 

1 . L o a d starti ng X-coo r d j^ n a t £_^_ d e^ s^ j^££ d _g £ a p h _m a^£ k e^£ s_^_£ n d^ 

vertical lines before enabling either single- or dual-strip 
cFart mode. The exact position of these points may vary once a 
strip chart is enabled. 

2. Any graph markers and vertical lines enabled will wrap around 
as the strip chart moves. 
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When the strip chart mode is disabled, any displayed graphics 
shifts. The X-coordinate that moved during strip char t mode 
returns to its normal location. 



J!![il.^Il_ All_.g"llzl t £^ p_ c h a ^ t mode , the last available graph 
position (X = 511) is not d i splay ed^_The_swj^t£h j_ng a ction 
between Graph and Graph 1 in that position is e iTin Fnated 
from the display. 



6-28 



CHAPTER 7 
VT125 COMMUNICATIONS 



GENERAL 

This chapter describes how the VT125 terminal communicates with 
with a computer using the standard EIA interface. Also included 
are descriptions of the communication features, a definition of 
the Break signal, a description of the communication of the 
graphics processor with the rest of the terminal and its options, 
and methods used to prevent input buffer overflows of the 
terminal . 

NOTE: The 20 mA current loop inte rface option (.YI!12i2iZ:^:^J i£ 

described in Chapter 10 Options, 

CONNECTING TO THE COMPUTER PORT 

The VT125 terminal is connected to a computer directly or through 
a common carrier facility (telephone line) as shown in Figure 7-1. 
In both applications, either the Electronic Industry Association 
(EIA) interface provided with the terminal or the VTIXX-AA 20 mA 
Current Loop interface option are used. Table 7-1 lists the 
Computer Port EIA connector signals. 

When connecting the terminal to the computer through a telephone 
line, a modem or acoustic coupler is needed. The modem or 
acoustic coupler changes the serial characters transmitted between 
terminal and computer into signals that can be transmitted over 
the telephone line. Several types of modems can be used with the 
VT125 terminal. However, the modem used by the terminal must be 
compatible with the modem used by the computer. 

CONNECTING TO THE AUXILIARY PORT 

The auxiliary port is for connecting a graphics or text printer to 
the VT125. It is bidirectional so it can also be used for input 
to the computer. The application program on the computer must use 
the Media Copy commands (Chapter 4, Communication and Graphic 
Protocol controls) to use the auxiliary port. 

SERIAL CHARACTER FORMAT 

The VT125 terminal communicates using serial characters. Serial 
characters are transmitted using a start bit, 7 or 8 data bits, an 
optional parity bit and one or two stop bits. Figure 7-2 shows an 
example of the serial character format used by the terminal. 
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Figure 7-1 Connecting to the Computer 
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Figure 7-2 Serial Character Format 
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Table 7-1 Computer Port EIA Connector Signals 



Pin Name 

1 Protective 
Ground 



Mnemonic 



PGND 



CCITT/EIA 
Designation 

101/AA 



Description 

Connected to the VT125 
chassis and to external 
ground through the third 
wire of the AC power 
cord. 



Transmitted TXD 
Data 



103/BA 



FROM VT125 
The VT125 transmits 
serial characters and 
Break signals on this 
circuit. This conductor 
is in the mark state 
when no characters or 
Break signals are being 
transmitted. 



Received 
Data 



Request 
to Send 



Signal 
Ground 



RXD 



RTS 



104/BB 



105/CA 



SGND 



102/AB 



TO VT12 5 

This conductor receives 
serial characters from 
the computer. 

FROM VT12 5 

This signal is on 

whenever the terminal is 

on. 

This conductor is the 
common ground reference 
potential for all 
connector signals except 
protective ground. Also, 
it is connected to the 
VT125 chassis. 



20 



23 



Data 

Terminal 

Ready 



DTR 



108.2/CD 



Speed 
Select 



SPDSEL 111/CH 



FROM VT12 5 

This signal is on except 
when the following 
conditions exist: 

• VT125 is not on 

• VT125 is LOCAL 

• During a reset 

• 3.5 seconds during a 
Long Break Disconnect. 

FROM VT12 5 

Also called Secondary 
Request to Send, this 
signal is on whenever 
the VT125 is on. 
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The number of data bits per character and parity are selected 
using the Parity Sense, Parity, and Bits Per Character SET-UP B 
features. If 8-bit characters are selected, the last data bit is 
forced to the Space (0) condition and the eighth data bit is 
ignored when receiving characters. The data bits are transmitted 
with the least significant bit first. (Refer to ANSI X3. 15-1976 
for details on the serial character format.) 

The parity bit is used to detect character transmission errors of 
both transmitted and received characters. The Parity Sense SET-UP 
B feature selects the type of parity bit used when transmitting 
and receiving characters. 

The Parity SET-UP B feature determines if the parity of received 
characters is checked or ignored. If the Parity SET-UP B feature 
is off, the parity bit is removed from the serial character. 

The number of stop bits (1 or 2) in^ the serial character is 
determined by the Transmit and Receive Speed SET-UP B features. 

BREAK SIGNAL 

A Break signal can be transmitted by the terminal. The Break 
signal is a transmitted space condition for 0.275 seconds +10 
percent. However, the computer response to the Break signal 
depends on the computer and software used. A Long Break 
Disconnect is a transmitted space condition for 3.5 seconds +10 
percent and then the Data Terminal Ready interface signal "is 
turned off. 

NOTE; On some modems, the Long Break Disconnect causes the modem 
to perform a communication line disconnect. 

FULL DUPLEX COMMUNICATION 

The VT125 terminal operates in full duplex communication. Full 
duplex communication means that the terminal transmits and 
receives characters at the same time. The VT125 provides some EIA 
signals as listed in Table 7-1. 

ELECTRONIC INDUSTRY ASSOCIATION (EIA) INTERFACE 

The VT125 communication interfaces are DB-25 (EIA RS-232-C type) 
male connectors mounted on the back of the terminal as shown in 
Figure 7-3. These connectors meet Electronic Industry Association 
(EIA) standards RS-232-C and CCITT V. 24 and V.28. When connecting 
to a device which meets EIA standard RS-232-C, the terminal can 
operate at speeds up to 19200 baud using communication cables up 
to 15 meters (50 feet) in length. Table 7-1 describes the EIA 
connector pin signals used by the computer port. Table 7-2 
describes the EIA connector pin signals used by the auxiliary 
port. All connector pins not described are not used by the 
terminal. Figure 7-3 shows the connector pin arrangement. 
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Figure 7-3 EIA Connectors and Pin Locations 
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Table 7-2 Auxiliary Port EIA Connector Signals 



Pin 



Name 



Mnemonic 



CCITT/EIA 
Designation 



Description 



Protective 
Ground 



PGND 



101/AA 



Transmitted 
Data 



TXD 



103/BA 



Connected to the VT125 
chassis and to external 
ground through the third 
wire of the AC power 
cord. 

FROM VT12 5 
The VT125 transmits 
serial characters and 
Break signals on this 
circuit. This conductor 
is in the mark state 
when no characters or 
Break signals are being 
transmitted. 



Received 
Data 



Data 

Set 

Ready 



RXD 



DSR 



104/BB 



107/CC 



Signal 
Ground 



SGND 



102/AB 



TO VT125 

This conductor receives 
serial characters from 
the auxiliary port. 

TO VT12 5 

The terminal receives 
Data Terminal Ready 
(DTR) from the printer 
on this conductor. If 
DSR is present at 
power-up, the printer 
controls print 
operations. If DSR is 
not present at power-up, 
then before each 
character print 
operation, the terminal 
checks again. If DSR is 
still not present, the 
print occurs. If DSR 
ever appears, then it 
controls all following 
prints. The terminal 
also uses DSR to detect 
the printer for the 
Device Attributes 
response (Chapter 4) . 

This conductor is the 
common ground reference 
potential for all 
connector signals. Also, 
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Table 7-2 Auxiliary Port EIA Connector Signals (Cont) 



Pin 



Name 



CCITT/EIA 
Mnemonic Designation Description 



20 



Data 

Terminal 

Ready 



DTR 



it is connected to the 
VT125 chassis. 

108.2/CD FROM VT125 

This signal is always ON 
when the terminal is on. 



SET-UP AND COMMUNICATIONS 

When you exit SET-UP, the terminal: 

• updates all aspects of its operation according to any new 
SET-UP feature selections, 

• sends XON to the computer port and auxiliary port if 
buffer space is available, 

• clears any received XOFF to allow transmission on all 
ports , 

• cancels any ReGIS Hard Copy operation. 

NOTE; Some graphic printers have large input buffers. A 
cancelled Hard Copy operation may not stop for several 
seconds while the printer empties its buffer. 

CONTROL FUNCTIONS 

The graphics processor is the control point for all communication 
in the VT125. (See Block Diagram, this chapter.) The graphics 
processor examines any ANSI control function arriving from any of 
the communication ports. if the graphics processor has the 
ability to respond to the control function, it acts on the control 
function and generally does not pass it along. If the graphics 
processor does not have a response for the control function, it 
ignores the control function and passes it to the device that is 
at the receiving end of the data path that the control function 
arrived on. 

From the keyboard, however, a special condition applies. The 
Escape character (ESC) has many software applications and must be 
allowed to pass to the application program. The following process 
decides when to pass ESC: 



ESC is held in 
mill iseconds . 



the graphics processor for a maximum of 50 
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b. If another character arrives within 50 milliseconds; 



• 



both characters are accepted by the graphics 
processor as part of a control function 

or 

• both characters are passed immediately if the 
control function does not apply to the graphics 
processor . 

c. If no character arrives within 50 milliseconds, the ESC 
is passed. 

50 milliseconds is a common delay between characters for a typist. 
Internal communications between the graphics processor and the 
VT100 text terminal operate with less than 20 ms delay between 
characters. The graphics processor does not have responses to the 
control functions transmitted by the special keys on the keyboard, 
so they are always passed through. 

COMMUNICATION CABLES 

Communications cables for both the EIA and 20 mA Current Loop 
interfaces of the terminal can be ordered from the DIGITAL 
Accessories and Supplies Group. Part numbers and ordering 
information for these cables is supplied in Chapter 11. Table 7-3 
describes each communication cable used and Figure 7-4 shows 
connection examples for each cable. 

BLOCK DIAGRAMS 

The VT125 is a complex device that has several separate processes 
operating at the same time to provide graphics and text over a 
simple terminal communication line. Figure 7-5 shows a general 
block diagram of the VT125. This shows two main functional 
blocks: the graphics processor and the VT100 text terminal that 
holds the graphics processor. The figure shows two important 
facts. 1. The keyboard communicates only with the VT100, so that 
LOCAL operation can only cause actions in the VT100, not in the 
graphics processor. 2. The graphics processor manages all 
communications between the computer and the VT100, and always uses 
XON/XOFF. (This SET-UP feature cannot be turned off.) 

Figure 7-6 is a more detailed look at the communication structure 
in the graphics processor itself. This shows the buffers that are 
included for each of the three bi-directional communication ports 
in the graphics processor. The Dispatcher is many processes. It 
controls the buffers with XON/XOFF. It sets up the data paths 
from each sending port to each receiving port. And it parses all 
communications according to ANSI X3. 64-1979. That is, it examines 
data from all ports for instructions to itself. It passes 
anything that does not apply to the graphics processor to 
whichever ports are set to receive the data from that source. 
Among the ports controlled by the dispatcher are the selection of 
the graphics protocol under ANSI sequence control. The choices in 
that block of the diagram are ReGIS, VT105 emulation, and 
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Figure 7-4 Cable Summary 
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Figure 7-5 VT125 General Block Diagram 
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Figure 7-6 VT125 Data Paths 
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Table 7-3 Interface Cables 



Number 



BC22A-10 



Length 



Connector Types 



Function 



BC22A-25 



BC22B-10 



BC22B-25 



BC03M-XX 



BC05D-XX 



BC05F-XX 



BC05X-XX 



10 ft 



25 ft 



10 ft 



25 ft 



variable 



variable 
variable 



variable 



RS-232 (female) 
to RS-232 (female) 



RS-232 (female) 
to RS-232 (female) 



RS-232 (male) 

to RS-232 (female) 



RS-232 (male) 

to RS-232 (female) 



RS-232 (female) 
to RS-232 (female) 



RS-232 (male) 

to RS-232 (female) 

Mate-N-Lok (male) 
Mate-N-Lok (male) 



Mate-N-Lok (male) 
to Mate-N-Lok (male) 



30-10958-02 EIA: 18 in RS-232 (male) 

20 mA: 8 ft to RS-232 (female) 
and 20 mA (male) 



Null modem; direct 
connection between 
VT125 and computer 
or printer 
(6-conductor cable) . 

Null modem; direct 
connection between 
VT125 and computer 
or printer 
(6-conductor cable) . 

Extension; connects 
VT12 5 to a modem 
(14-conductor cable) . 

Extension; connects 
VT125 to a modem 
(14-conductor cable) . 

Null modem; direct 
connection between 
VT125 and computer or 
printer. 

Extension; connects 
VT125 to a modem. 

20 mA; direct to 
connection between 
VT125 with a 20 mA 
option installed and 
a computer. (Supplied 
with 20 mA option.) 

20 mA extension 
cable. 

Connection between 
DF01-A acoustic 
coupler and VT125 EIA 
or 20 mA. 



DECwriter graphics. The following five figures show the internal 
connections that are set up for different applications. 

Figure 7-7 shows the VT125 operating as a text-only terminal. 
This is how the terminal operates when it is first powered up. If 
you send XOFF from the keyboard, either by pressing NO SCROLL (if 
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Figure 7-7 VT125 as Text-Only Terminal 
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AUTO XON/XOFF is on) or by pressing the S key while pressing the 
CTRL key, the receive buffer in the VT100 fills to the 32 
character mark. Then the VT100 sends XOFF to the graphics 
processor. When the 16 character transmit buffer in the graphics 
processor fills, it sends XOFF to the dispatcher, and then the 128 
character receive buffer fills to its 48 character mark. At that 
point, 80 characters later, the graphics processor sends XOFF to 
the computer. 

Figure 7-8 shows the VT125 operating as a graphics terminal. A 
Device Control String is being sent to the terminal from the 
computer. The terminal may be in any protocol: ReGIS, VT105, or 
DECwriter graphics. The keyboard can communicate with the 
computer, but any screen response to keyboard commands is under 
the control of the computer's programming. 

Figure 7-9 shows the VT125 operating as a graphics terminal. A 
Device Control String is being sent to the terminal from the 
computer. The graphics protocol commands are being displayed on 
the screen at the same time. This is a feature of VT125 ReGIS and 
is not available with the other protocols. The keyboard can 
communicate with the computer, but any screen response to keyboard 
commands is under the control of the computer's program. 

Figure 7-10 shows the VT125 printing from the screen to the 
optional graphics printer in DECwriter graphics protocol. This is 
the result of the Screen Hard Copy command in ReGIS. The keyboard 
can communicate with the computer, but the computer cannot 
communicate with the dispatcher until the print operation is 
complete. However, if a Graphics Off command (String Terminator: 
ESC \) immediately follows the Hard Copy command, the computer can 
communicate with the dispatcher during the print operation. 

Figure 7-11 shows the VT125 printing from the computer to the 
optional printer. This is the result of the ANSI Media Copy 
command from the computer. The Media Copy command can turn the 
VT100 and auxiliary (printer) ports on and off. Therefore, the 
screen could display the data that is going to the printer if 
wanted. To print a stored DECwriter graphics protocol file, 
display it on the screen and then use the ReGIS Hard Copy command 
to print it. 

INPUT BUFFER OVERFLOW PREVENTION 

When the terminal receives a character (other than the NUL and DEL 
characters) , the character is placed in a 128 character input 
buffer. The input buffer holds the received character until the 
dispatcher processes the character. When processed, the character 
is removed from the input buffer. 

If received characters are placed in the input buffer faster than 
the characters are processed, the input buffer begins to fill with 
characters. If the input buffer becomes full, all new characters 
received are lost and the Substitute character (OD) is displayed. 
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Figure 7-8 VT125 in a Graphics Protocol 
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Figure 7-9 



VT125 in ReGIS Graphics with Commands on 
Screen 
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Figure 7-10 VT125 Printing from Screen 
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Figure 7-11 VT125 Printing from Computer 
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Using XON and XOFF characters between the terminal and the devices 
it communicates with prevents input buffer overflow. The graphics 
processor always has an automatic XON/XOFF protocol in operation. 
The many different operations that the processor can perform, from 
graphics protocols to local printing, take widely different 
amounts of time to perform. The techniques of Fill Characters and 
Low Speed Operation that are suggested as alternate methods of 
buffer overflow prevention for the VT100 text terminal cannot be 
used with the VT125 graphics terminal. 

XON and XOFF Control Characters 

The XON and XOFF control characters indicate the number of 
characters in an input buffer. When the 128 character input 
buffer of the graphics processor holds 48characters, the graphics 
processor transmits XOFF (DCS, octal 023). The computer or other 
device should stop transmitting characters. 

As the dispatcher removes characters from the input buffer, the 
number of characters in the buffer decreases. When the input 
buffer holds 16 characters, the graphics processor transmits XON 
(DCl, octal 021) requesting the computer to continue transmission. 

If the computer fails to respond to the XOFF character transmitted 
by the graphics processor, the input buffer continues to fill. 
The graphics processor transmits a second XOFF when the input 
buffer holds 112 characters. This second XOFF is a last request 
to the computer to stop transmitting characters before overflow. 
Then, an overflow at 128 characters transmits a final XOFF. 

To determine how fast the computer must respond to the first XOFF 
character to avoid input buffer overflow, use the following 
formulas : 

No. of characters to overflow = 80 - [3 X (receiver speed/ 

transmit speed) ] 

Time to respond to XOFF = No . of characters to overflow X 

(bits per character + parity bit + number of stop bits + 

l)/receiver speed. 

Example 1: 

The graphics processor transmits and receives 8-bit characters 
with no parity at 1200 baud. When the graphics processor 
transmits the first XOFF, the computer must stop transmitting 
within 0.608 seconds or the input buffer overflows. 

No. of characters to overflow = 80 - [3 X 1200/1200)] = 73 
characters 

Time to respond to XOFF = 73 X (8+0+1+1) /1200 = 0.608 second 
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Example 2: 

The graphics processor is transmitting and receiving 7-bit 
characters with parity at 300 baud. When the graphics processor 
transmits the first XOFF, the computer must stop transmitting 
within 2.4 seconds or the input buffer overflows. 

No. of characters to overflow = 80- [3 X 300/300]= 73 characters 

Time to respond to XOFF = 73 X (7+1+1+1) /300 = 2.4 seconds 

NOTE; If the input buffer overflows, received characters are 
ignored and the Substitute character (OP) is displayed. 

EFFECTS OF RESET AND TESTS 

Two control sequences. Reset and Invoke Confidence Test, 
initialize the terminal and erase all buffers. This means that 
characters received while these two functions are processed are 
lost. Therefore, immediately after sending the Reset or Invoke 
Confidence Test sequences, the computer should assume that it 
received an XOFF from the terminal. The computer should then send 
no more characters until it receives XON. The terminal transmits 
XON only after it completes the test. 

NOTE; The Reset and Invoke Confidence Test sequences may cause the 
terminal to disconnect from the communication line. 

TRANSMIT BUFFERS 

The transmit buffers hold characters generated by the terminal 
before they are transmitted to the computer. The computer can use 
the XON (DCl, octal 021) and XOFF (DC3, octal 023) characters to 
control the transmission of characters from the terminal. 

Receipt of XOFF stops the graphics processor from transmitting any 
characters except XOFF and XON. When the 16 character transmit 
buffer fills, the dispatcher stops accepting characters from the 
receive buffer of the port that is transmitting (for example, the 
VT100) . When the receive buffer fills with 48 characters, it sends 
XOFF to its sender (in this example, the VT100) . It transmits a 
second XOFF if the buffer fills to 112 characters. From seven to 
nine characters are stored in the VT100 keyboard buffer. (Some 
keys transmit three characters at once. The buffer locks at 7 
characters to prevent loss of the added characters of a three 
character keystroke.) If the keyboard buffer fills, the KBD LOCKED 
indicator turns on and keyclicks stop (if the Keyclick SET-UP B 
feature is on) . 

Receipt of XON starts the transmission of characters again. The 
16 character transmit buffer empties and the dispatcher moves 
characters from the receive buffer to the transmit buffer. When 
the receive buffer empties to the 16 character level, it sends XON 
to the transmit buffer in the VT100. (Also, entering and exiting 
SET-UP turns off the KBD LOCKED indicator and allows the VT100 to 
transmit characters. However, characters transmitted after 
entering and exiting SET-UP may be lost if the receive buffer is 



7-17 



not ready to receive characters.) When the keyboard buffer 
empties, the KBD LOCKED indicator turns off and keyclicks occur 
when keys are pressed (if the keyclick feature is ON) . 
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CHAPTER 8 
INSTALLATION 



GENERAL 

This chapter contains the information needed to unpack, pack, and 
install the VT125 terminal. The Installation Procedure describes 
how to select the proper input voltage selection and fuse for 
either 120 or 220 — 240 VAC operation. The Power Up and Checkout 
Procedure provides a step-by-step procedure for powering up the 
VT125 terminal. 

SITE CONSIDERATIONS 

The VT125 terminal is made up of a video monitor and a detachable 
keyboard. Their dimensions are shown in Figure 8-1. Table 8-1 
lists the environmental and power specifications of the terminal. 
If the terminal will be used with a color video monitor, you must 
get four video cables that are long enough for your location. 

NOTE; When installing the terminal, make sure that all power and 

obstructions. Also, be sure to provide access to the power switch 
on the back of the terminal. 

Be sure not to block air flow around the terminal. There are 
several ventilation openings to prevent the terminal from 
overheating. Do not block these openings by placing objects on 
top or under the terminal. Also, do not allow liquids, coins, 
paper clips, and other objects to enter these ventilation 
openings. These objects may cause damage to the terminal. For 
this reason, do not put drinks or metal objects on the top of 
terminal . 

The terminal may be placed on a desk or table top. However, 
people ususlly prefer the keyboard at standard typewriter table 
height rather than desk height. Terminal tables and stands are 
available from DIGITAL Accessories and Supplies Group. (Refer to 
Chapter 11 for more information on Accessories.) 

Position the terminal to avoid reflected light. Usually, the 
terminal is positioned facing away from light sources that reflect 
off the screen. However, if reflected light is a problem, 
non-reflective and anti-glare screens are available from DIGITAL 
Accessories and Supplies Group. Also, anti-static mats are 
available from DIGITAL Accessories and Supplies Group for 
installations with static electricity problems. 
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Figure 8-1 VT125 Terminal Dimensions 
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Table 8-1 Site Considerations 



Site Consideration Specification 



Temperature 10o to 40o C (50o to 104o F) 

Relative Humidity 10 to 90 percent with a maximum wet bulb 

temperature of 28o C (82o F) and a maximum 
dew point of 2o C (36o F) noncondensing 

Input Voltage 90 to 128 VAC 180 to 256 VAC (switch 

selectable) 

Power Consumption 250 VA apparent, 150 W maximum 

Power Receptacle Nonswitched, grounded 



INSPECTION 

The VT125 terminal is packed in a reinforced carton containing the 

following items: 

Monitor 

Keyboard 

AC Power Cord 

SET-UP Label 

- User Guide 

- Programming Reference Card 

Inspect the terminal for damage and check that all the listed 
items are present. 

NOTE; If damaged, notify the carrier and your local DIGITAL Sales 
Office. 

INSTALLATION PROCEDURE 

The VT125 terminal can be installed using a 3 mm (1/8 in) blade 
screwdriver. However, more tools may be needed when installing 
any accessories and options. To install the VT125 terminal, use 
the following general procedure (refer to Figure 8-2 for the 
switch and cable locations) : 

1. Unpack and inspect the terminal. 

2. Check the terminal for the proper voltage range 
selection. The terminal can operate with either 120 VAC 
or 220 — 240 VAC input power. 

CAUTION; Failure to select the proper voltage range will 
damage the terminal. 

A label over the power receptacle indicates the factory 
selected input voltage range. Check this label and the 
Voltage Selection switch to be sure that the voltage 

8-3 



ACCESS 
COVER 



EIA 

AUXILIARY 

PORT 



RED 

GREEN V VIDEO OUTPUTS 

BLUE 



KEYBOARD KEYBOARD 20MA CONNECTOR VOLTAGE 

CABLE CABLE (WHEN INSTALLED) SELECTION 

CONNECTOR SWITCH 



FUSE 




.POWER 
RECEPTACLE 



Figure 8-2 Monitor Controls and Connector Location 
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range of the terminal is the same as your local ac power 
source. Select the proper input voltage range if needed. 

c. Install the correct power cable for your power source. 
(A list of available cables is in Chapter 11. 

3. Attach the SET-UP label to the bottom of the keyboard. 
Remove the backing paper on the self-sticking SET-UP 
label, then attach the label. 

4. Place the keyboard in front of the terminal and plug the 
keyboard into the keyboard connector located at the back 
of the terminal. 

5. Connect the ac power cable to a nonswitched, grounded ac 
power receptacle. 

NOTE; Check to be sure the Power switch is in the off 
position before connecting the power cord. 

6. Perform the Power Up and Checkout procedure in this 
chapter. When the Power Up and Checkout Procedure is 
completed continue this installation procedure. 

7. Turn off the power and disconnect the power cord. 

8. If needed, install the Advanced Video Option (VTIXX-AB) 
and the 20 mA Current Loop Option (VTIXX-AA) at this 
point in the installation procedure. Perform the option 
installation and option checkout procedures in Chapter 
10. 

9. Connect the communication cable to the appropriate 
connector at the back of the terminal. If using the EIA 
interface, fasten the connector to the terminal with the 
captive screws using a 3 mm (1/8 in) blade screwdriver. 
Be sure to attach the cable ground wire to one of the 
captive screws (Figure 8-3) . (Refer to Chapter 5 for 
information about connector use and signal/pin 
definitions . ) 

10. Connect an optional external video monitor. If the 
monitor is color, use three video cables to connect the 
Red, Green, and Blue outputs from the VT125 to the inputs 
on the monitor. See Figure 8-2. Connect the composite 
video output from the VT125 to the sync input on the 
monitor, and set the monitor to select external 
synch r on i zation . 



If the monitor has the ability to pass the video signals 
to another device ( "loopthrough" ) , be sure that either 
the monitor (if alone) or the last device in the string 
is set to terminate the video and sync signals in 75 
ohms . 
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If the external monitor is monochrome (black and white) , 
connect only the composite video output from the VT125 to 
the monitor input. Be sure the video signal is 
terminated in 75 ohms. The video output signals and the 
other connector, the video input, are described in detail 
in Appendix A. 

11. Connect an optional printer to the auxiliary port. See 

Chapter 7 Communication, Chapter 2 SET-UP, and the 

printer's user guide for information about setting the 

communication features of both the printer and the 
auxiliary port to the same values. 

Performing these procedures completes the installation of 
the terminal. 

POWER UP AND CHECKOUT PROCEDURE 

A Power Up Self Test verifies the proper operation of the VT125 
terminal each time the terminal is powered up. Perform the 
following procedure to power up and checkout the terminal: 



1. Turn the Power switch to the on position (refer to Figure 
8-2 for the switch location) . The terminal automatically 
uns the Power Up Self Test. The test gives the 
ollowing indications: 

Keyboard and screen flash on and off. 

All keyboard indicators turn on and off, and either 
the ON LINE or LOCAL indicator is turned on. 

The Wait message is displayed on the screen and then 
is erased. 

A bell tone is generated. 

A band of light appears at the top of the screen and 
is erased. 

Another bell tone is generated. 

A message appears to announce the result of the 
VT125 self-test, and a box is drawn* around the 
margins of the graphics screen area. (This message 
stays on the screen until the first character 
arrives over the communication line.) 



NOTE: No messages appear on the screen until th e 
terminal warms up. 



Not on all units. 
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The text cursor is 
corner of the screen. 



displayed in the upper-left 



Any error found by the Power Up Self Test is 
displayed on the screen as a character, as a 
message, on keyboard indicators L1-L4, or by several 
bell tones. Refer to the Self Test Error Codes 
section of Chapter 9 for more information about the 
error indications. 

If the terminal powers up correctly, continue with the 
installation procedure if you are going to install any 
options. Then select the SET-UP features you want as 
described in Chapter 2. 

When the SET-UP features are selected, record the feature 
selections on the SET-UP label attached to the bottom of 
the keyboard. 
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CHAPTER 9 
OPERATOR MAINTENANCE AND TROUBLESHOOTING 



GENERAL 

This chapter describes maintenance procedures, troubleshooting 
(what to do in the event of a problem) and self tests used with 
the VT125 terminal. Try to troubleshoot the terminal yourself 
before requesting service. 

MAINTENANCE 

The VT125 terminal needs no preventive maintenance. However, its 
cabinet may be cleaned with any mild detergent that does not use 
solvents. When cleaning the terminal: 

CAUTION: Do not use too much detergent when cleaning the terminal. 
If liquids get inside the terminal, the terminal may be damaged. 

• To clean the surfaces of the terminal, apply the 
detergent to a cloth or tissue and then clean the 
terminal . 

• To clean the screen, apply the detergent to a cloth or 
tissue and then clean the screen. 

• To clean the keys, rub with a dry or moist cloth. 

CAUTION; Do not remove the keycaps when cleaning; the 
keyswitch contacts can be damaged if the keyc aps are 
replaced incorrectly. 

WHAT TO DO IN THE EVENT OF A PROBLEM 

If the terminal appears to be faulty, perform the following 

procedure. If the problem is not solved by this procedure, refer 

to Table 8-1 for a list of typical problems. 

1. Turn the Power Switch to the off position and check the 
following : 

a. Power Cord — be sure the cord is connected securely 
at both the terminal and at the wall outlet. Check 
the wall outlet with another device such as a lamp 
to be sure that it is providing ac power. 

b. Voltage Selection Switch and Fuse — be sure the 
switch is in the correct position and the fuse is 

9-1 



good. (Remove the fuse holder cap by pressing it in 
and turning it counter-clockwise. Replace the fuse 
holder cap by pressing it in and turning it 
clockwise . ) 

c. Keyboard Coiled Cord — check that the cord is 
securely plugged into the keyboard connector at the 
back of the terminal. 

2. Turn the Power Switch to the on position, the terminal 
performs the Power Up Self Test. (Refer to the Power Up 
Self Test Description for more information about the 
power up test.) If the terminal does not power up 
correctly, call your local DIGITAL service office. 

3. If needed, perform the Computer Port Data Loopback Self 
Test with an optional EIA loopback connector (see Chapter 
11 for ordering information) . (Refer to the Loopback 
Test descriptions in this chapter for more information.) 

VT125 SELF TESTS 

The VT125 terminal has several self tests available for checking 
the operation of the terminal. Some of these are the self tests 
of the VT100 terminal that the VT125 graphics processor resides 
in. The other tests are for the graphics processor itself. 

The Power Up Self Test is performed each time the terminal is 
powered up. The other tests may be performed after the Power Up 
Self Test is completed. To perform the other tests the terminal 
must be disconnected from the communication line and an external 
loopback connector installed. 

POWER UP SELF TEST 

A Power Up Self Test is built into the VT125 terminal to test the 
operation of the terminal. The test checks the general operation 
of the VT100 terminal, including the Advanced Video Option if 
installed, the user permanent SET-UP feature memory and the 
keyboard, and the general operation of the graphics processor, 
including the bit map memory. 

To perform the Power Up Self Test, turn the terminal on, or if 
power is on, enter SET-UP and press the (RESET) key. Prepare the 
terminal with the following procedure if the test must be run 
continuously : 

1. With the Power switch off, disconnect the communication 
cable and install the loopback connector on the EIA 
connector, refer to Figure 8-1. The EIA loopback 
connector part number is 12-15336. If the 20 mA Current 
Loop Adapter Option is installed, use the loopback 
connector (pn 70-15503-00) that was included with the 
option. Do not use the EIA loopback connector at the same 
time as the current loop connector. 

2. Turn the Power switch on. 
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Table 9-1 Problem Checklist 



Symptom 



Possible Cause 



Corrective Action 



ON LINE or LOCAL 
indicator on with 
no cursor on screen. 

ON LINE or LOCAL 
indicators not on 
with no keyboard 
response. Cursor 
on screen. 

KBD LOCKED 
indicator on. 



Terminal does not 
respond to typed 
characters . 
Keyclicks generated 
and keyboard 
indicators function, 

Wrong or Substitute 
(S) characters 
or no characters 
appearing on the 
on the screen. 



Several bell tones 
during power up. 
Reset or Recall. 



Screen Brightness too 
low. 



Keyboard cable not 
connected to terminal, 



Keyboard buffer full, 
keyboard cannot accept 
more characters. 
Terminal was XOFFed 
by computer. 



Screen can not be 
updated by the 
Computer. Terminal 
XOFFed Computer. 



Incorrect SET-UP 
feature selection 



Computer error 



Read or write 
problem with user 
permanent memory. 



Enter SET-UP and 
increase the screen 
brightness . 

Turn off terminal 
and connect keyboard 
cable . 



Entering and Exiting 
SET-UP clears this 
condition. Caution: 
characters may be 
lost using this 
procedure. 

Press the NO SCROLL 

key. 

or 

Enter and exit 

SET-UP. 



Correct the SET-UP 
features. Suggested 
SET-UP features that 
may be in error: 
ANSI/VT5 2 Mode 
Auto XON/XOFF 
Bits per character 
Parity 

Parity sense 
Receive Speed 
Transmit Speed 

Check computer 
system. 

Check the SET-UP 
feature settings 
and try the Save 
operation. 
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3. Be sure the terminal is ON LINE with the ANSI/VT52 SET-UP 
B feature selected to ANSI (SET-UP B switch 2-3 = 1) . 
Type one of the following sequences to perform the test. 



Performs the Power Up Self Test 
once . 



Performs the Power Up Self Test 
continuously. 



ESC [ 4 ; 1 y 
ESC [ 4 ; 9 y 

NOTES: This test can also be performed with the VT100 
power-up test sequence ( <ESC> [ 2 ; ly) . The continuously 
running test ends only if an error is found or if power 
is turned off. 

The test gives the following indications: 

Keyboard and screen flash on and off. 

All keyboard indicators turn on and off, and either 
the ON LINE or LOCAL indicator is turned on. 

The Wait message is displayed on the screen and then 
is erased. 

A bell tone is generated. 

A band of light appears at the top of the screen and 
is erased. 

Another bell tone is generated. 

A message appears to announce the result of the 
VT125 self-test, and a box is drawn* around the 
margins of the graphics screen area. 

NOTE: No messages appear on the screen until th e 
terminal warms up. 

The text cursor is displayed in the upper-left 
corner of the screen. 

Any error found by the Power Up Self Test is 
displayed on the screen as a character, as a 
message, on keyboard indicators L1-L4, or by several 
bell tones. Refer to the Self Test Error Codes 
section of this chapter for more information about 
the error indications. 

COMPUTER DATA PORT LOOPBACK SELF TEST 

The Computer Port Data Loopback test checks that the VT125 

terminal can transmit and receive characters over the computer 



* Not on all units, 
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data port. The transmit and receive lines must be connected to 
each other with an external loopback connector. 

To perform the Data Loopback Self Test, use the following 
procedure : 

1. With the Power switch off, disconnect the communication 
cable and install the loopback connector on the computer 
data port connector. See Figure 8-1. The EIA loopback 
connector part number is 12-15336. If the 20 Ma Current 
Loop Adapter Option is installed, use the loopback 
connector (pn 70-15503-00) that was included with the 
option. Do not use the EIA loopback connector at the same 
time as the current loop connector. 

2. Turn the Power switch on. The terminal performs the power 
up self test. 

3. Be sure the terminal is ON LINE with the ANSI/VT52 SET-UP 
B feature selected to ANSI (SET-UP B switch 2-3 = 1) . The 
transmit and receive speeds must be the same and 300 baud 
or faster. Type one of the following sequences to perform 
the test. 

ESC [ 4 ; 1 ; 2 y Performs the Power Up and 

Computer Data Port loopback 
self tests. 

ESC [ 4 ; 1 ; 2 ; 9 y Performs the Power Up and 

Computer Data Port loopback 
self tests continuously until 
failure. 

NOTE: The continuously running test ends only if an error 
is found or if power is turned off. 

The test gives the following indications: 

• Either the ON LINE or LOCAL indicator is turned on. 

• The Wait message is displayed on the screen and then 
is erased. 

• The cursor is displayed in the upper-left corner of 
the screen. 

• If the Computer Data Port loopback test fails, the 
message "VT125 EC Error" is displayed on the 
internal monitor. 

4. Turn the Power Switch off, remove the loopback connector 
and connect the communication cable. 
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AUXILIARY PORT LOOPBACK TEST 

The Auxiliary Port Data Loopback test checks that the VT125 
terminal can transmit and receive characters over the auxiliary 
data port. The transmit and receive lines must be connected to 
each other with an external loopback connector. 

To perform the Auxiliary Port Data Loopback Test, use the 
following procedure: 

1. With the Power switch off, disconnect any cable from the 
auxiliary port and install the EIA loopback connector. 
See Figure 8-1. The EIA loopback connector part number 
is 12-15336. 

2. Turn the Power switch on. The terminal performs the 
power up self test. 

3. Be sure the terminal is ON LINE with the ANSI/VT52 SET-UP 
B feature selected to ANSI (SET-UP B switch 2-3 = 1). 
Type one of the following sequences to perform the test. 

ESC [ 4 ; 1 ; 3 y Performs the Power Up and 

Auxiliary Data Port loopback 
self tests. 

ESC [ 4 ; 1 ; 3 ; 9 y Performs the Power Up and 

Auxiliary Data Port loopback 
self tests continuously until 
failure. 

NOTE; The continuously running test ends only if an error 
is found or if power is turned off." " 

The test gives the following indications: 

• Either the ON LINE or LOCAL indicator is turned on. 

The Wait message is displayed on the screen and then 
is erased. 

The cursor is displayed in the upper-left corner of 
the screen. 

If the test fails, the message "VT125 SC Error" is 
displayed. 

4. Turn the Power Switch off, remove the loopback connector 
and connect the communication cable. 

DISPLAY TEST 

This test requires that you check the screen of the internal 
monitor and the color monitor (if present) for correct operation. 
The screen cycles through the four intensity levels of each of the 
three primaries and white to test the output memory. The computer 
data port must have the loopback connector installed. 
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Table 9-2 Display Test Indications 



Monochrome Color 



Step 1 Black White Light Dim Black Light Black Black 

Grey Grey Red 

Step 2 Dim Black White Light Dim Dim Dim Dim 

Grey Grey BLue Red Green Grey 

Step 3 Light Dim Black White Light Light Light Light 

Grey Grey Blue Red Green Grey 

Step 4 White Light Dim Black Light Light Light Black 

Grey Grey Green Red Blue 

Step 5 White Light Dim Black Black Black Black Black 

Grey Grey 



To perform the Display Test, use the following procedure: 

1. With the Power switch off, disconnect the communication 
cable and install the loopback connector on the computer 
data port connector. See Figure 9-1. The EIA loopback 
connector part number is 12-15336. If the 20 Ma Current 
Loop Adapter Option is installed, use the loopback 
connector (pn 70-15503-00) that was included with the 
option. 

Do not use the EIA loopback connector at the same time as 
the current loop connector. 

2. Turn the Power switch on. The terminal performs the 
power up self test. 

3. Be sure the terminal is ON LINE with the ANSI/VT52 SET-UP 
B feature selected to ANSI (SET-UP B switch 2-3 = 1) . 
Type one of the following sequences to perform the test. 

ESC [ 4 ; 1 ; 4 y Performs the Power Up and 

Display self tests. 

ESC [ 4 ; 1 ; 4 ; 9 y Performs the Power Up and 

Display self tests continuously 
until failure. 

NOTE: The continuously running test ends o nly if an 
error is found or if power is turned off. 

The test gives the indications listed in Table 9-2. 
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Figure 9-1 EIA Loopback Connector 
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VIDEO BIT MAP MEMORY TEST 

This test checks that every bit in both video bit map planes can 
be written to both one and zero. The computer data port must have 
the loopback connector installed. 

To perform the Video Bit Map Memory Test, use the following 
procedure : 

1. With the Power switch off, disconnect the communication 
cable and install the loopback connector on the computer 
data port connector. See Figure 8-1. The EIA loopback 
connector part number is 12-15336. If the 20 Ma Current 
Loop Adapter Option is installed, use the loopback 
connector (PN 70-15503-00) that was included with the 
option. Do not use the EIA loopback connector at the same 
time as the current loop connector. 

2. Turn the Power switch on. The terminal performs the 
power up self test. 

3. Be sure the terminal is ON LINE with the ANSI/VT52 SET-UP 
B feature selected to ANSI (SET-UP B switch 2-3 = 1) • 
Type one of the following sequences to perform the test. 

ESC [ 4 ; 1 ; 5 y Performs the Power Up and Video 

Bit Map Memory tests. 

ESC [ 4 ; 1 ; 5 ; 9 y Performs the Power Up and Video 

Bit Map Memory tests 
continuously until failure. 

NOTE: The continuously running test ends only if an error 
is found or if power is turned off. 

The test gives the following indications: 

• The screen fills with levels of intensity (or color) 
moving from top to bottom. 

If this test fails, the message "VT125 BM Error" is 
displayed. 



• 



VT125 SELF TEST ERROR CODES 

If any of keyboard indicators Ll through L4 are lit at the end of 
power-up self-test, or if the complete screen flashes, request 
service for the terminal. 

If a character appears under the blinking cursor at the top left 
corner of the screen, or a message appears in the center of the 
screen, check Table 9-3 for the meaning of the error code 
character or message. Note that the character displayed could 
mean that more than one error has been detected. To clear the 
error indication after the error is corrected. Reset or Power up 
the terminal. 
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Table 9-3 Displayed Error Codes 

Character Faults Detected - 

Displayed AVO Memory 



1 
2 
3 
4 
5 
6 
7 



X 
X 
X 
X 



Keyboard 



X* 
X 



X 
X 



X** 
X 
X 
X 



Message 
Displayed 

VT125 OK 



Faults Detected 



None - normal power up test results 



VT125 Offline VT100 text terminal is LOCAL. LOCAL was saved in 

SET-UP, or User Permanent Memory problem. 

VT125 BM Error Video Bit Map Memory. One or more bad pixels. 

VT125 VG Error Vector Generator 

VT125 IC Error Internal Communications 

VT125 SC Error Auxiliary Port 

VT125 EC Error Computer Port 



* Also, bell tones generated - perform a Save and Recall in 

SET-UP 
** Be sure keyboard is properly connected 



There are three types of errors indicated by the self test code 
characters. They are: 



Advanced Video Option 
(AVO) if installed 



User Permanent SET-UP 
Feature Memory failure 
(Memory) 



Keyboard missing or 
malfunction (Keyboard) 



If the advanced video option 
fails, the terminal operates 
with the basic VT100 text 
capabilities. 

If the user permanent SET-UP 
feature memory fails, the 
terminal operates using default 
SET-UP feature selections for each 
of the features. (Refer to Chapter 
2 for more information on the 
SET-UP feature memories.) 

If only the keyboard fails, the 
terminal ends the test ON LINE, 
so that it may operate as a 
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receive-only terminal. The SET-UP 
feature selections cannot be 
changed. 

There are six types of errors indicated by the Self Test error 
messages. They are: 

VT125 Offline VT100 text terminal is LOCAL. LOCAL was saved 

in SET-UP, or User Permanent Memory problem. 
Terminal can only process received graphics 
commands . 

VT125 BM Error Video Bit Map Memory has one or more bad 

pixels. 

VT125 EC Error Computer Port failed data loopback test. 

Terminal can only operate as text terminal in 
LOCAL. 

VT125 IC Error Internal Communications failure. VT125 cannot 

communicate with VT100. Terminal can only 
process received graphics. 

VT125 SC Error Auxiliary Port failed data loopback test. 

Terminal cannot send data to printer. 

VT125 VG Error Vector Generator could not draw sample shape. 

Graphics probably does not work, but terminal 
may communicate normally. 

A box is drawn around the margin of the graphics screen area.* If 
any part of the box is missing or distorted, the graphics board 
needs service. 

Table 9-3 shows the possible error characters that are displayed 
on the screen and the failure indicated by each character. Notice 
that the character displayed could indicate that more than one 
error has been found. 



* Not on all units. 
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CHAPTER 10 
OPTIONS 



GENERAL 

The VT125 Graphics Terminal is a VT100 text terminal with a 
factory installed graphics processor. There are two more options 
that can be installed into the VT125 at its operating location. 
They are the 20 mA Current Loop Option and the Advanced Video 
Option. Other options that can be used with the VT125 are a color 
monitor and a graphics hard copy printer. Installation of the 
monitor and printer is explained in the installation chapter. This 
chapter explains the installation of options into the VT125 
itself. 

This chapter also explains the installation of the VTIXX-CB and 
-CC Graphics processors into the VT100 and VT105. 

20 MA Current Loop Interface Option (VTIXX-AA) 

Description 

The 20 mA Current Loop Option is an optional interface used to 

connect the VT125 terminal to a computer. The 20 mA option ia a 

board installed into the VT125 terminal and an interface 

connector. Figure 10-1 shows the 20 mA current loop interface 

connector and pin assignments. The 20 mA current loop interface 

option can operate at a distance up to 304 meters (1000 feet) . 

NOTE: The VT125 terminal is designed to use either 20 mA or EIA 
communications. If EIA is used on a terminal that has the 20 mA 
option installed, the cable connecting the 20 mA option board to 
the terminal controlller board must be disconnected. 

Both the transmitter and receiver of the 20 mA interface board can 
be selected for active and normal (passive) operation. Usually, 
the terminal is connected for normal (passive) operation. Passive 
operation means that the terminal does not supply the 20 mA 
current needed during communication. The transmitter goes to the 
mark condition when power is turned off. 

Active operation means that the terminal supplies the 20 mA 
current needed during communication. In an active configuration, 
there is no isolation and the transmitter goes to the space 
condition when power to the terminal is turned off. 
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Figure 10-1 20 mA Connector and Pin Locations 
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20 MA Option Installation 

The VTIXX-AA current loop option is installed using a 5 mm (3/16 
in) blade screwdriver and a 2 Phillips screwdriver. Use the 
following procedure to install the 20 mA current loop option: 

1. Turn Power switch to the off position and disconnect the 
power cord. See Figure 10-1. 

2. Unplug the keyboard. 

3. If installed, disconnect any video cables. 

4. If installed, disconnect any communication cables. 

5. Remove the 20 mA option board from the VT100 access cover 
it came in. 

6. With a 2 Phillips screwdriver, remove the four screws 
holding the VT125 access cover in place. See Figure 10-1. 
Remove the access cover. 

7. Install the 20 mA current loop option board onto the 
access cover with the three Phillips head screws provided 
with the option. See Figure 10-2. 

8. Install the 20 mA connecter to the bottom of the access 
cover with the two hex head screws provided with the 
option using a 5 mm (3/16 in) screwdriver. 

9. Select TRANSmit and RECeive switches for the proper 
configuration. See Figure 10-3. 

NOTE: Th ese switches must b e selected fo£_NORMAL 
(passive) operation to perform the loopback test. The 
loopback test verifies proper operation of the option 
after installation. 

10. Connect the adapter cable provided with the option to 
the 20 mA board. See Figure 10-4. Place the access cover 
next to the opening in the back of the terminal and 
connect the other end of the cable to the connector on 
the terminal controller board. 

11. Place the access cover into the opening of the terminal 
and tighten the four screws to fasten it. 

12. Perform the Computer Data Port Loopback Test. 

Computer Data Port Loopback Self Test 

The Computer Port Data Loopback test checks that the VT125 
terminal can transmit and receive characters over the computer 
data port. The transmit and receive lines must be connected to 
each other with an external loopback connector. 
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Figure 10-2 



20 mA Current Loop Option 
Board Installation 
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Figure 10-3 



20 mA Current Loop 
Option Switches 
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Figure 10-4 



20 mA Current Loop 
Option Cable Position 
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To perform the Data Loopback Self Test, use the following 
procedure : 

1. With the Power switch off, disconnect the communication 
cable and install the loopback connector (pn 70-15503-00) 
that was included with the option on the computer data 
port connector. See Figure 10-5. 

2. Turn the Power switch on. The terminal performs the power 
up self test. 

3. Be sure the terminal is ON LINE with the ANSI/VT52 SET-UP 
B feature selected to ANSI (SET-UP B switch 2-3 = 1) . 
The terminal transmit and receive speeds must be the same 
and 300 baud or faster. Type one of the following 
sequences to perform the test. 

ESC [ 4 ; 1 ; 2 y Performs the Power Up and 

Computer Data Port loopback 
self tests. 

ESC [ 4 ; 1 ; 2 ; 9 y Performs the Power Up and 

Computer Data Port loopback 
self tests continuously until 
failure. 

NOTE; The continuously running test ends only if an error 
is found or if power is turned off. 

The test gives the following indications: 

• Either the ON LINE or LOCAL indicator is turned on. 

• The Wait message is displayed on the screen and then 
is erased. 

• The cursor is displayed in the upper-left corner of 
the screen. 

• If the Computer Data Port loopback test fails, the 
message "VT125 EC Error" is displayed on the 
internal monitor. 

4. Turn the Power Switch off, remove the loopback connector 
and connect the communication cable. 

Advanced Video Option 

Description 

The Advanced Video Option adds the following features to the text 
terminal capabilities of the VT125: 

• 10 additional lines of 132 column display. The screen 
can now display a total of 24 lines in either 80- or 
132- column format. 
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Figure 10-5 20 mA Loopback 
Connector 
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• Additional character attributes - any text terminal 
characters can now be highlighted in any of the 
following ways: Bold, Blink, Underline, Reverse, any 
combination of the four. 

• Capability to use an additional character generator ROM, 
for another resident character set. 

Installation 

Use the following procedure to install the Advanced Video Option. 

The VTIXX-AB Advanced Video option is installed using a 5 mm (3/16 
in) blade screwdriver. Use the following procedure to install the 
option. 

1. Turn Power switch to the off position and disconnect the 
power cord. See Figure 10-1. 

2. Unplug the keyboard. 

3. If installed, disconnect any video cables. 

4. If installed, disconnect any communication cables. 

5. With a 2 Phillips screwdriver, remove the four screws 
holding the access cover in place. See Figure 10-2. 
Remove the access cover. 

6. If a 20MA current loop option is installed, disconnect 
the short cable from the terminal controller board. (See 
Figure 10-4.) 

7. Remove the ground wires from the terminal controller and 
graphics processor boards. 

8. Loosen the two large boards from their sockets, one at a 
time, and then pull them out together about 5 cm (2 in). 

9. Remove both flat cables from the graphics processor 
board. See the VT100 upgrade procedure illustrations in 
this chapter. 

10. Remove the terminal controller board from the chassis. 

11. Locate the four mounting holes drilled in the terminal 
controller board for the AVO and mount a plastic standoff 
in each hole. (See Figure 10-6.) 

12. Holding the Advanced Video Option board by the edges, 
align the AVO connector with the pins on the terminal 
controller board. Press the board into place. 
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Figure 10-6 



Advanced Video Option 
Location and Installation 
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13. Slide the terminal controller partially into the chassis 
and reconnect the two flat cables to the graphics 
processor board. 



14, 



Reconnect the ground wires to the terminal controller and 
graphics processor boards. 



15. Slide both boards into the chassis together, taking care 
not to stretch the cables. Seat both boards in their 
sockets, one at a time. 

16. Place the access cover into the opening of the terminal, 
replacing the 20 ma adapter cable if present, and tighten 
the four screws. 

17. Replace the power cord. 

18. Perform the Advanced Video Option Test. 

Advanced Video Option Test 

Use the following procedure to check out the operation of the 

Advanced Video Option. 

1. Turn the terminal power on and check that no error was 
detected during the power up self test. 

2. Press the SET-UP key. The words "SET-UP A" should blink 
in boldface, the words "TO EXIT PRESS SET-UP" should be 
underlined, and the tab ruler at the bottom of the screen 
should have alternating normal and reverse video 
sections even if the cursor is selected to be underline. 

3. Place the terminal in 132 - column mode and then in 

LOCAL. 

4. Exit SET-UP and type the following sequence: 
ESC < ESC # 8 

The screen should now display 24 lines X 132 columns. 

VTIXX-CB OR -CL INSTALLATION INTO VT100 AND VT105 

The VTIXX-CB or -CL is a kit of all the parts needed to install a 

VT125 Graphics processor into a VT100 or VT105. 



NOTE 


TO < 


CUSTOMER: 


Please 


do 


not try to install 


this 


compl ex 


option. Call your DIGITAL 


Fie: 


Id Service branch 


for 


assistance. 


NOTE 


: Bef 


ore installing th 


e G 


raphics Processor, 


check 


the 


ROMs and 


the 


etch 


revision 


level on the terminal contro 


Her 


board 


(at step 


7 of 


this 


procedure 


) . Comp 


are 


the numbers of th 


e ROMs 


on 


the board 


with 


the 


numbers in 


Figure 


10- 


-7. They should be 


equal 


or 


larger . 
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ROM 3 
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CONTROLLER BOARD. 



Figure 10-7 Check ROM Numbers 
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Check the etch number on the solder side of the board. Look for 
the number 5013008 followed by a letter. If the letter is D, E, 
etc. the board can be used. If the letter is A^ B^ or C, you 
cannot use the board. 



If either of these prerequisites cannot be met, consult your Field 
Service branch office for information. 

1.0 TOOLS NEEDED 

1/4 inch nutdriver, 2 Phillips screwdriver, needlenosed pliers, 

3/16 inch blade screwdriver. 

2.0 INSTALLATION PROCEDURE 

1. Turn off the power and disconnect the power cord. 

2. Unplug the keyboard. 

3. Remove the access cover (4 phillips screws or four 
slotted plastic screws (See Figure 10-1.) If a 20 mA 
current loop option is installed, disconnect the short 
cable from the terminal controller board. (See Figure 
10-4.) 

4. Remove the shipping bolts if installed (1/4 inch hex 
head) . You can discard them. 

5. Release the pop fasteners at the front and back of the 
terminal with a blade screwdriver and remove the top 
cover. (See Figure 10-8.) 

6. Release the pop fasteners at the front and back of the 
chassis with your fingers and remove the chassis from the 
bottom cover. 

7. Remove the terminal controller board from the chassis. 

8. Remove the terminal controller edge connector by either 
1. releasing the two retaining rings from the edge 
connector with needlenosed pliers, or 2. lifting the 
clips at the top and bottom of the edge connector and 
discarding the clips. 

9. On VT100: Remove the terminal controller edge connector 
by either a. releasing the two retaining rings from the 
edge connector with needlenosed pliers, or b. lifting the 
clips at the top and bottom of the edge connector and 
discarding the clips. 

On VT105: Disconnect the power cable from the VT105 
expansion backplane and remove the backplane. (See Figure 
10-9.) 

10. Install the new expansion backplane with four 12.7 mm 
(1/2 in) X 4-40 screws and keps nuts and four 6.4 mm (1/4 
in) spacers. Install the screws at the connector 
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Figure 10-8 Top Cover Removal 
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Figure 10-9 Expansion Backplane 
Installation 
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positions marked Jl and J5 on the board. (See Figure 
10-9.) Be sure that the small red connector clears the 
inner edge of the card cage. The DC power cable must be 
flat against the chassis or the backplane will not fit. 

11. Bend the DC power cable around so that the opening faces 
the CRT. Remove the alignment key in the connector 
opening with pliers if it is present. Install the 
connector onto the board edge connector, passing the 
cable around the wire frame if it is present. (See Figure 
10-9.) 

factory-assembled VT125 terminals that comply with the 
FCC EMI specification. 



12. Install card guides into the top and bottom of 
cage at the VT125 connector position. 



the card 



13. At the fourth hole from the left on the top of the 
chassis (over the BNC bracket) press the ground clip with 
a wire onto the chassis (Figure 10-10) . 



14. Install the FCC RF shield (Figure 10-11): a. Loosen but 
do not remove two Phillips screws at the top of the 
shield, b. Set the chassis on end with the cage up. 



NOTE: 


The terminal 


rests on 


several 


parts that 


stick 1 


out 


on the bottom. 


Set 


the terminal on a 


protected surface 


to 


prevent damage. 
There are bump( 


• 

Bts attached to both sides of the 


chassis . 


They 


protect 


the 


terminal 


during 


shipping and can 


be 



15, 



c. Loosen but do not remove two Phillips screws at the 
bottom of the shield, d. Slide the shield onto the cage, 
e. Tighten the four Phillips screws. 

Put the chassis into the bottom cover and press the pop 
fasteners to close them. Put the top cover over the 
terminal and press its pop fasteners to close them. 



16. Slide the 
chassis . 



terminal controller board partially into the 



17. Install either end of the 16 pin flat cable connector to 
the lower 16 pins of the terminal controller board's 
graphic connector (marked J2 on the terminal controller 
board) with the cable entering from the left. Fold the 
cable over the connector to the right. (See Figure 
10-12.) 
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NOTE: 
INSTALL CLIPS BEFORE 
INSTALLING SHIELD. 



Figure 10-10 Installing Ground Clips 
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Figure 10-11 16 Pin Flat Cable on 
Terminal Controller 



10-18 



STANDOFF 



NYLON WASHER 




TERMINAL CONTROLLER 



Figure 10-12 STP Paddleboard Installation 
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Figure 10-13 24 Pin Flat Cable 
on STP Board 



10-20 



18. Install the STP paddle board in the STP connector. Lift 
the 16 pin cable slightly if needed to clear the spacer 
when inserting the STP board. Attach it to the terminal 
controller board with the supplied screw and washer. (See 
Figure 10-13.) 

19. Find the end of the 24 pin cable that has pin 1 on the 
cable side. The red strip should be on the left. Fold the 
cable under itself to the right approximately 3 
centimeters (one inch) from the connector and install 
that end into the socket on the paddle board with the 
cable down. (See Figure 10-14.) 

20. Install the VT125 board into the chassis so that it 
sticks out approximately 5 centimeters (2 inches) more 
than the terminal controller board. 

21. Arrange the 16 pin graphic connector with the cable 
entering from below and install it into the connector at 
the top edge of the VT125 board. (See Figure 10-15.) 

22. Arrange the 24 pin connector with the cable entering from 
the right and install it into the 24 pin socket at the 
right edge of the VT125 board. (See Figure 10-15.) 

23. Check the switches on the STP paddle board and set 
switches 1,3, and 4 off, with all the other switches on. 
(See Figure 10-16.) 



24. Connect the ground wire from the 
the quick-connect terminal on the 
See Figure 10-17. 



top of the chassis to 
BNC connector bracket. 



25. Slide both boards into the chassis together, taking care 
not to stretch the cables. Seat both boards in their 
sockets, one at a time. 

26. If the 20 mA adapter was installed on the VT100, remove 
the adapter board from the VT100 access cover and install 
it into the new access cover. (See procedure in this 
chapter . ) 

27. Install the 20 mA connector cable (if present) to the red 
connector on the terminal controller board. 

28. Adjust the cables in the access opening and install the 
access cover, tightening the four screws carefully. 

29. Perform the power up and checkout procedure that is 
described in Chapter 8. 
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Figure 10-14 Graphic Cable Connections 
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Figure 10-15 Paddleboard Switches — Variations 
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Figure 10-16 Connecting BNC Bracket Ground Wire 
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Figure 10-17 RF Shield Installed 
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CHAPTER 11 
ACCESSORIES AND SUPPLIES INFORMATION 



GENERAL 

This chapter describes the accessories and supplies offered for by 
DIGITAL for the VT125 terminal. Included in this chapter is a 
description of the accessories and supplies, their part numbers 
and ordering information. 

ACCESSORIES AND SUPPLIES 

Item No. Part No. Description 

VT125 formed screen filter, gray, 
anti-glare coating 

VT125 non-reflective filter screen 

VT125 terminal stand with casters 

Heavy gauge vinyl dust cover, charcoal 
brown. 

Anti-static floor mat, DECmat, 122 cm / 
183 cm (4 ft. / 6 ft.). Driftwood color 
(brownish gray) 

H9850-DB Anti-static floor mat, DECmat, 122 cm / 

183 cm (4 ft. / 6 ft.). Summer Earth 
color (brown/gold) 

H9850-DC Anti-static floor mat, DECmat, 91 cm / 

305 cm (3 ft. / 10 ft.). Silver Birch 
color (silvergray/brown) 

H9850-DD Anti-static floor mat, DECmat, 91 cm / 

305 cm (3 ft. / 10 ft.). Autumn Bronze 
color (orange/brown) 

H9850-DE Anti-static floor mat, DECmat, 91 cm / 

305 cm (3 ft. / 10 ft.). Driftwood color 
(brownish gray) 



1 


VTIXX-AE 


1 


VTIXX-AR 


2 


VTIXX-ST 


3 


H9850-HK 


4 


H9850-DA 
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Figure 11-1 Accessories and Supplies Group 
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Item No. Part No. 

4 H9850-DF 

4 H9850-DH 

5 H970-EB 
5 H970-HB 



6 


LA12X-UA 


6 


LA12X-UB 


6 


LA12X-UC 


6 


LA12X-UD 


6 


LA12X-UE 


6 


LA12X-UF 


6 


LA12X-UH 


6 


LA12X-UJ 


6 


LA12X-UL 


6 


LA12X-UM 


6 


LA12X-UN 


6 


LA12X-UP 


6 


LA12X-UR 


6 


LA12X-US 


6 


LA12X1-A 


8 


30-10958-02 


9 


VTIXX-AA 




VTIXX-AB 



Description 

Anti-static floor mat, DECmat, 122 cm / 
183 cm (4 ft. / 6 ft.). Silver Birch 
color (silvergray/brown) 

Anti-static floor mat, DECmat, 122 cm / 
183 cm (4 ft. / 6 ft.). Autumn Bronze 
color (orange/brown) 

Terminal table, 68.6 cm high / 91.4 cm 
wide / 76.2 cm deep (27 in. / 36 in. / 30 
in.) with levelers 

Terminal table, 68.6 cm high / 61.0 cm 
wide / 76.2 cm deep (27 in. / 24 in. / 30 
in.) with levelers 

Blank keycap kit of 50, Row 4* 

Blank keycap kit of 50, Row 1* 

Blank keycap kit of 50, Row 2* 

Blank keycap kit of 50, FJ type 

Blank keycap kit of 50, SET-UP 

Blank keycap kit of 50, TAB 

Blank keycap kit of 50, CAP LOCK 

Blank keycap kit of 50, SHIFT 

Main array blank key cap set 

Blank keycap kit of 50, CR 

Blank keycap kit of 50, ENTER 

Blank keycap kit of 50, Num Pad 

Blank keycap kit of 50, Row 3* 

Blank keycap kit of 50, Row 5* 

Acoustic telephone coupler, 300 baud 

Cable interface DF01-A couplers to VT125 
terminals 

20 mA current loop option with BC05F-15 
cable . 

Advanced video option. 
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Item No. Part No. 
10 BC22A-10 



10 



10 



10 



10 



BC22A-25 



BC22B-10 



BC22B-25 



BC23A-10 



Description 

EIA RS232 female- female null modem cable 
shielded 3.0m (10 ft.) 

EIA RS232 female-female null modem cable 
shielded 7.6m (25 ft.) 

EIA RS232 male-female extension cable 
shielded 3.0m (10 ft.) 

EIA RS232 male-female extension cable 
shielded 7.6m (25 ft.) 

Kit of 5 BC22A-10 



10 



BC23A-25 



Kit of 5 BC22A-25 



10 
10 



BC23B-10 
BC23B-25 



Kit of 5 BC22B-10 
Kit of 5 BC22B-25 



NOTE; EIA RS-232-C specifies a maximum cable length of 15 m (50 
ft). EIA RS-423 specifies a maximum cable length of 61 m (200 
ft) . 



10 



10 



10 



10 



10 



10 



10 
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BC03M-AO Female-female null modem cable 30.5m (100 
ft.) 

BC03M-B5 Female-female null modem cable 76.2m (200 
ft.) 

BC03M-EO Female-female null modem cable 152.4m (500 
ft.) 

BC03M-LO Female-female null modem cable 304.8m (1000 
ft.) 

BC05X-15 20 mA current loop extension cable 4.6m (15 
ft.) 

BC05X-25 20 mA current loop extension cable 7.6m (25 
ft.) 

BC05X-50 20 mA current loop extension cable 15.2m 
(50 ft.) 

H9532-AA Work-station desk with blue front panel and 

gray side panels, levelers, 122 cm wide / 

76.2 cm high / 76.2 cm deep (48 in. / 30 
in. / 30 in.) 
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Item No. Part No. Description 

11 H9532-AB Work-station desk with brown front panel 

and brown side panels, levelers, 122 cm 
wide / 76.2 cm high / 76.2 cm deep (48 in. 
/ 30 in. / 30 in.) 

12 H9850-AP Media mate, file or shelf storage cart with 

casters and lockable drawer, 64.1 cm high / 
38.1 cm deep / 47.0 cm wide (25.25 in. / 15 
in. / 18.5 in. ) 

POWER CORDS: 

17-00083-09 United States (120 V) 

17-00083-10 United STates (240 V) 

17-00209-00 United Kingdom 

17-00199-00 Continental Europe (SCHUKO) 
17-00211-00 Switzerland 
17-00198-00 Australia 



ALIGNMENT TEMPLATES: 

94-03220-3 Screen Alignment Template 

94-03246-3A Character Width Template 

94-03246-3B Character Height Template 

DATA LOOPBACK TEST CONNECTORS: 

12-15336-00 EIA Loopback Connector 

70-15503-00 Current Loop Connector 

RELATED DIGITAL DOCUMENTATION: 

13 EK-VT125-UG VT125 User Guide — Describes the 

installation, operation and programming of 
the VT125 terminal. This document is 
shipped with the terminal. 
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13 EK-VT100-J1-003 VT100 Series Pocket Service Guide — 

Describes procedures used to troubleshoot 
and repair the VT125 terminal to the module 
level (field replacable unit). 

13 EK-VT100-TM VT100 Series Technical Manual — Describes - 

VT125 terminal to a detailed block level. 
It provides troubleshooting information for 
the terminal. This technical manual does 
not contain detailed schematic drawings. 
The VT125 Field Maintenance Print Set has 
detailed schematic drawings. The VT125 
Field Maintenance Print Set is ordered 
separately. 

13 EK-VT125-IP VT125 Video Terminal IPB — Describes a 

detailed parts breakdown of the VT125 field 
replacable units. This document does not 
contain part numbers for components on the 
printed circuit boards. However, components 
are listed in the the VT125 Field 
Maintenance Print Set. The VT125 Field 
Maintenance Print Set is ordered 
separately. 

13 EK-VT125-RC VT125 Terminal Programming Reference Card 

— Provides a summary of the VT125 ReGIS 
escape and control sequences on a pocket 
size reference card. 

14 MP-01053-00 VT125 Field Maintenance Print Set — 

Provides a complete set of electrical and 
mechanical schematic diagrams for the VT125 
terminal . 

14 MP-01052-00 VTIXX-CB and -CL Field Maintenance Print 

Set — Provides a complete set of 
electrical and mechanical schematic 
diagrams for the VT125 terminal. 

SPARES KIT: 

4A-VT125-00 VT125 Spares Kit 

ORDERING INFORMATION 

Continental USA 

Call 800-258-1720 or mail order to: 

Digital Equipment Corporation 
P.O. Box CS2008 
Nashua, NH 03061 
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New Hampshire 

Call 602-884-6660 or mail order to 

Digital Equipment Corporation 
P.O. Box CS2008 
Nashua, NH 03061 

Alaska or Hawaii 

Call 408-734-4915 or mail order to 
Digital Equipment Corporation 
632 Caribbean Drive 
Sunnyvale, CA 94086 

Canada 

Call 800-267-6146 or mail order to; 

Digital Equipment Corporation 

P.O. Box 13000 

Kanata, Ontario 

Canada K2K 2A6 

Att: ASG Business Manager 

Telex: 610-562-8732 
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APPENDIX A 
VT125 SPECIFICATIONS 



GENERAL 

This apppendix lists the specifications of the VT125 terminal and 
provides X-ray emission statements, loopback connector wiring, and 
a list of related documentation not provided by DIGITAL. 

VT125 SPECIFICATIONS 



Dimensions 
Monitor 



Keyboard 



Height: 36.83 cm (14.5 inch) 
Width: 45.72 cm (18 inch) 
Depth: 36.20 cm (14.25 inch) 

Height: 8.89 cm (3.5 inch) 

Width: 45.72 cm (18 inch) 

Depth: 20.32 cm (8 inch) 

Minimum table depth: 51.4 cm (20.25 

inch) 



Weight 

Monitor 
Keyboard 
Shipping Weight 



14.6 kg (32.2 lbs) 
2.0 kg (4.5 lbs) 
19.6 kg (43.2 lbs) 



Environment 
Operating 



Non-Operating 



Power 

Line Voltage 



Temperature: 
(50 to 104° 



10 

F) 
Humidity: 



to 40 



Relative 

Max wet bulb: 28 
Min dew point: 2° 
Altitude: 2.4 Km 



10% 



to 
C (82° F) 
C(36° F) 
(8,000 ft) 



to 66 



90% 



Temperature: -4( 

(-40° to 151° F) 

Relative Humidity: to 95% 

Altitude: 9.1 km (30,000 ft) 



99 — 128 V RMS single phase, 2 wire 
198—256 V RMS single phase, 2 wire 
(selected by switch) 
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Line Frequency 
Current 



Input Power 
Current limiting 

Power cord 

Power cord 
receptacle 



Display 
CRT 



Format 



Character 
Character size 



Active Display Size 
Character Set 



Cursor type 



47 Hz— 63 Hz 

2.20 A RMS maximum at 120 V RMS 

1.10 A RMS maximum at 240 V RMS 

150 W RMS or 250 VA apparent 

3.0 A fast blow fuse 

Detachable, 3-conductor grounded 

EIA specified CEE22-6A 

12 inch diagonal measure, P4 phosphor 

24 lines X 80 characters or 14 lines X 
132 characters (selected from keyboard 
or computer) (24 X 132 with Adavnced 
Video Option) 

7 X 10 dot matrix with descenders 

80-column mode 

3.35 mm X 2.0 mm (0.132 inch X 0.078 

inch) 132-column mode 

3.35 mm X 1.3 mm (0.132 inch X 0.051 

inch) 

202 mm X 115 mm (8 inch X 4.5 inch) 

ASCII and UK displays 96 characters 
(with upper- and lowercase, numeric and 
punctuation) , 32-character special 
graphics set 

Blinking block character or blinking 
underline (selected from keyboard) 



Keyboard 

General 



Key Layout 



Auxiliary Keyboard 



Visual Indicators 



Audible Indicators 



83-key detachable unit with a 1.9 m (6 
ft) coiled cord attached 

65-keys arranged similar to standard 
typewriter with 18-key auxiliary 
keypad. 

18 keys with period, comma, minus, 
enter, and four general purpose 
function keys 

Seven: ON LINE, LOCAL, KBD LOCKED, and 
four programmable. 

Audible keyclick for each keystroke 
(selectable from keyboard) 
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Communication 
Type 

Speeds 



Code 

Character format 

Character size 

Parity 

Buffer overflow- 
prevention 



Composite Video 
Output (J9) 



Bell: sounds when BEL character 
received, and 2) sounds eight 
characters from right margin (selected 
from keyboard) 

Multiple bell sounds on error in SET-UP 
save or recall operation 



Full Duplex EIA 

50, 75, 110 (two stop bits) , 134.5, 
150, 200, 300, 600, 1200, 1800, 2000, 
2400, 3600, 4800, 9600, 19,200 baud 
(selected from keyboard) 

ASCII (ISO 646 and CCITT Alphabet 5) 

Asynchronous 

7 or 8 bits (selected from keyboard) 

Even, odd or none (selected from 
keyboard) 

Automatic generation of XON and XOFF 
control codes. The VT125 Graphics 
Terminal requires XON/XOFF support in 
its host computer 

The composite video output provides 
RS170 output with the following nominal 
characteristics (Figure A-1) . 

Output impedance = 75 ohms, dc coupled 
SYNC level = 0V 

Black level = approximately 0.3 V when 
loaded with 75 ohms 

White level = approximately 1.0 V with 
a 75 ohm load 

Composite sync waveform meets EIA RS170 
standards . 

Vertical interval is six equalizing 
pulses, six vertical sync pulses, and 
six more equalizing pulses, 'riming is 
as follows: 

Equalizing pulse width 

2.33 us +50 ns 
Vertical pulse width 

27.28 us +200 ns 
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EVEN FIELD: 



LAST DISPLAYED SCAN OF 
PREVIOUS FIELD 



VERTICAL BLANKING INTERVAL 



ov liiririi 



[60 Hz NON-INT = 22 SCANS 
I 60 Hz INT = 22 SCANS ( 

I 50 Hz NON-INT = 75 SCANS / 
50 Hz INT = 74 SCANS I 



60 Hz NON-INT = 2 SCANS 
60 Hz INT =2 SCANS 

50 Hz NON-INT = 25 SCANS 
50 Hz INT =24 SCANS 



nnnmnjLMiiiTimnnn^ 



FIRST OF 240 DISPLAYED 
SCANS IN EVEN FIELD 



^ 



ODD FIELD: 

LAST DISPLAYED SCAN OF 
EVEN FIELD 



START OF 
EVEN FIELD 



VERTICAL BLANKING INTERVAL 



r60H 
I 50 H 



I 
feO Hz INT = 23 SCANS "1 
"^50 Hz INT = 76 SCANS j 



z INT = 2.5 SCANS 
Hz INT = 24.6 SCANS 



innr"" 

JH PERIOD = 63.56 us ± .01% 



FIRST OF 240 DISPLAYED 
SCANS IN ODD FIELD 



if^inmmmmuJLiiJinrinnrT 

I START OF 
ODD FIELD 



inT'ir 



BRIGHT = 1.00 V- 

NORMAL = .79 V- 

DIM = .64 V- 



BLACK = .29 V-»-- 
SYNC = 0.00 -»■ 



FRONT PORCH = 1.54 jis ±60ns 

H SYNC = 4.71 us ± 50 ns -• 



Hh 



\_12.34 fi: 



s ± 50 ns / 80 COLUMN 
s ± 50n5 / 132 COLUMN 



-ff- 



-H PERIOD = 63.56 lis ± .01% 



/V 



u 



-H PERIOD =63.56 MS ± -01% 

NOTES: 

IN NON-INTERLACED OPERATION THE 
EVEN FIELD IS REPEATED CONTIN- 
UOUSLY. AND THE ODD FIELD IS NOT 
USED 

IN THE INTERLACED OPERATION THE 
EVEN FIELD ALTERNATES WITH THE ODD 
FIELD. 

ALL FIELDS CONTAIN 240 DISPLAYED 
SCANS. 

MA-1993A 



~M U L 

EQ = 2.33 ys ± 50 ns -»| |«- -^ 



n TL. 

U-V SYNC = 27.28 us 
± 200 ns 



Figure A-1 Composite Video Output 
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Horizontal pulse width 

4.71 us +50 ns 
Horizontal blank width 

11.84 us +50 ns/80 column mode 

12.34 us +50 ns/132 column mode 
Front Porch 

1.54 us +50 ns 



Color Video Outputs 

Each of the color outputs is a 

output impedance of 75 ohms and 

when loaded with 75 ohms. No 

outputs. 



DC coupled analog signal with an 
a level ranging from to 1 volt 
sync is available on the color 



Video Input 

An analog signal applied to the video input will be "ORed" with 
the internal video signal so the beam intensity at any point on 
the screen will correspond to the intensity of that signal which 
would tend to make the beam brighter at that point. A video signal 
on this input affects only the internal screen and does not appear 
on the composite video output. This input has the following 
nominal characteristics: 

1. Input impedance = 75 ohms, dc-coupled 

2. Black level = V 



3. 



White level = 1.0 V 



4. Maximum continuous input = +-2.0 V 

The external video source must be synchronized to the 
may do this by referencing the composite sync on the 
video output. This means that the VT125 video input 
synchronize with any composite video source. 



X-RAY Emission Data 

Rated anode voltage; 

Dose rate: 
Compliance with: 



VT125; it 
composite 
will not 



12 kV (fixed) 

Less than 1.43 pA/kg (20 uR/h) * 

Paragraph 5, clause 2 of German 
X-Ray ordinance (1973) 
CSA 22.2 no. 154-1975 
Paragraph 4.1.4 

0804/5.72, Paragraph 23 
0730 part 2P/6.76, Paragraph 
0860 part 1/11.76, Paragraph 
65 public 1/1972, Paragraph ( 
no. 65 
478 
EMC A 57 





VDE 




VDE 




VDE 




lEC 




CSA 




UL 



33 
6 



* Measured at a distance of 5 cm 
point from the outer surface. 



(1/96 inch) at any accessible 
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Workstation exposure Does not expose the operator to dangerous 

X-ray radiation 

LOOPBACK CONNECTOR WIRING 
From To 

EIA 

Pin 2 Pins 3 and 15 

Pin 4 Pins 5 and 8 

Pin 20 Pins 6 and 22 

Pin 19 Pins 12 and 17 

20 mA 

Pin 1 Pin 3 

Pin 2 Pin 7 

Pin 5 Pin 8 

RELATED DOCUMENTATION 

ANSI specifications can be ordered at the following addresss. 

Sales Department 

American National Standards Institute 

1430 Broadway 

New York, N.Y. 10018 

EIA specifications can be ordered at the following address. 

Electronic Industries Association 
Engineering Department 
2001 Eye St. NW 
Washington, DC 20006 

International standards can be ordered at the following address. 

CCITT 

UN Book Store 

United Nations Building 

N.Y., N.Y. 10017 



A- 6 



APPENDIX B 

SET-UP B SUMMARY 



GENERAL 

This appendix provides a summary of the VT125 terminal SET-UP 
features. Table B-1 lists the SET-UP features. Figure B-1 shows 
the screen displays. Figure B-2 is a summary of the SET-UP B 
features. 
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Table B-1 SET-UP Feature Types 



SET-UP Feature 

ON LINE/LOCAL 
Screen brightness 
Columns per line 
Tab stops 

Scroll 
Auto repeat 
Screen background 
Cursor 



Operator 
Preference 



X 
X 
X 
X 



Communication 
Compatibility 



Installation 



X 
X 



Margin bell 
Keyclick 
ANSI/VT52 
Auto XON/XOFF 

US/UK character set 

Auto wrap 

Line feed/new line 

Interface 



X 
X 



X 
X 



X 
X 



X 



Parity sense 
Parity 
Bits per 
Power 



character 



AUX port bits 

character 

AUX port speed 

Transmit speed 

Receive speed 

Answerback 



per 



X 
X 
X 



X 
X 
X 
X 



X 
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SET-UP A 

TO EXIT PRESS "SET-UP" 



I T T T T T T T T T 

l234567890(lHI;tBiHgl2345e7890lWl.mi:Kl23456789O (>*(M!W!| !lgl23456789O [>^^ 



SET-UP B 

TO EXIT PRESS "SET-UP' 



1 [US 2 SOB 3 H 4 S S H T SPEED 9S00 R SPEED 9fi00 



Figure B-1 SET-UP B Display 
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SET-UP B 

TO EXIT PRESS "SET-UP* 



DELIMITER CHARACTER 

\ ANSWERBACK MESSAGE 

\. \ 

A= lUP TO 20 CHARACTERS 

1 [UH 2 EQB 3 H ^ ffi 5 H T SPEED SeOO R SPEED 9600 



Figure B-2 SET-UP B Summary 
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APPENDIX C 
TRANSMITTED CHARACTER SUMMARY 



GENERAL 

This appendix lists the character codes generated by the VT125 

terminal. 

STANDARD KEYS 

Figure C-1 shows the codes generated by the standard keys. 



OCTAL CODES GENERATED BY KEYBOARD 











SHIFTED CODES SHOWN ABOVE KEYCAP 


LLC 


hNL 


JS 
























UNSHIFTED CODES SHOWN BELOW KEYCAP LEGENDS) 
















041 


100 


043 


044 


045 


136 


1 046 


062 


050 


051 


137 


153 


176 










1 1 


2& 


3# 


4S 


5% 


6 A 


7& 


8 • 


9( 


01 





= + 


\ - 










061 


062 


063 


064 


065 


066 


067 


070 


071 


060 


055 


075 


140 










121 


127 


105 


122 


124 


131 


125 


111 


117 


120 


173 


175 















W 


E 


R 


T 


Y 


U 


I 





P 


II 


II 












161 


167 


145 


162 


164 


171 


165 


151 


157 


160 


133 


135 










CAPS 


101 


123 


104 


106 


107 


110 


112 


113 


114 


072 


042 






174 






A 


S 


D 


F 


G 


H 


J 


K 


L 








\| 








141 


163 


144 


146 


147 


150 


152 


153 


154 


073 


047 




134 








132 


130 


103 


126 


102 


116 


115 


074 


076 


077 






" 






SHIFT 


Z 


X 


C 


V 


B 


N 


M 


< 


> 


/? 


SHIFT 










172 


170 


143 


166 


142 


156 


155 


054 


056 


057 










040 








SPACE 
















040 

















Figure C-1 Standard Key Codes 
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FUNCTION KEYS 

Figure C-2 shows the control codes generated by the function keys. 

For the shaded keys, CTRL does not need to be pressed in order to 

generate the control character. Table C-1 lists the control codes 

generated. 













MNEMONICS SHOWN ABOVE KEYCAP LEGENDS 
OCTAL CODES SHOWN BELOW KEYCAP LEGENDS 










HERE 
IS 












ESC 
ESC 
033 


























RS BS 

\ - BACK 
SPACE 

036 010 


BREAK 




HT 

TAB 
Oil 


XON 

Q 
021 


ETB 
W 
027 


ENQ 

E 
005 


DC2 

R 
022 


DC4 

T 
024 


EM 

Y 

031 


NAK 

U 
025 


HT 

I 

Oil 


SI 



017 


OLE 

P 
020 


ESC 

II 

033 


GS 

II 
035 


CR 

ETUflN 

015 


DEL 

DELETE 
177 




CTRL 




SOH 

A 
001 


XOFF 

S 
023 


EOT 
D 

004 


ACK 

F 
006 


BEL 

G 
0O7 


BS 

H 

010 


LF 

J 

012 


VT 

K 

013 


FF 

L 

014 






R 


FS 

\l 

034 








SUB 

Z 
032 


CAN 

X 
030 


ETX 

C 
003 


SYN 

V 
026 


STX 

B 
002 


SO 

N 
016 


CR 

M 

015 


, < 


> 


US 

/? 

037 




LF 

LINE 
FEED 

01? 


















NUL 
000 















Figure C-2 Function Key Control Codes 
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Table C-1 Control Codes Generated 









Code 






Control 


Character 


(Octal) 


Key Pressed 


Dedicated 


Character 


Mnemonic 


Sent 


with CTRL 


Key 


Null 


NUL 




000 


Space Bar 




Start of heading 


SOH 




001 


A 




Start of text 


STX 




002 


B 




End of text 


ETX 




003 


C 




End of transmission 


EOT 




004 


D 




Enquire 


ENQ 




005 


E 




Acknowledge 


ACK 




006 


F 




Bell 


BEL 




007 


G 




Backspace 


BS 




010 


H 


BACK SPACE 


Horizontal 


HT 




011 


I 


TAB 


Tabulation 












Line feed 


LF 




012 


J 


LINE FEED 


Vertical tab 


VT 




013 


K 




Form feed 


FF 




014 


L 




Carriage return 


CR 




015 


M 


RETURN (ENTl 


Carriage return 


CR LF 


015 012 




RETURN (ENT 


Line feed 












Shift out 


SO 




016 


N 




Shift in 


SI 




017 







Data Link Escape 


DLE 




020 


P 




Device control 1 


DCl 


(XON) 


021 


Q 




Device control 2 


DC 2 




022 


R 




Device control 3 


DC 3 


(XOFF) 


023 


S 




Device control 4 


DC4 




024 


T 




Negative acknowledge 


NAK 




025 


U 




Synchronous idle 


SYN 




026 


V 




End of transmission 


ETB 




027 


W 




Block 












Cancel previous word 


CAN 




030 


X 




or character 












End of medium 


EM 




031 


Y 




Substitute 


SUB 




032 


Z 




Escape 


ESC 




033 


[ 




File separator 


FS 




034 


\ 




Group separator 


GS 




035 


] 




Record separator 


RS 




036 


*• 




Unit separator 


US 




037 


? 




Delete 


DEL 




177 




DELETE 



* The RETURN character code can be changed by the line feed/new 
line feature. When off, this feature causes RETURN to generate a 
single control character (CR) . When on, this feature causes 
RETURN to generate two characters (CR, LF) . Also, depending on 
the keypad mode selected, RETURN and ENTER may generate the same 
control codes. 
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APPENDIX D 
PROGRAMMING SUMMARY 



GENERAL 

This appendix provides a 

sequences . 

CONTROL CHARACTERS 



summary of the VT125 escape and control 



Name 
Null 



Character 
Mnemonic 

NUL 



Enquire ENQ 
Bell BEL 

Backspace BS 



Horizontal HT 
Tab 



Line Feed LF 



Vertical VT 
Tab 



Octal 
Code 

000 



005 
007 

010 



011 



012 



013 



Function 

Ignored when received (not 
stored in input buffer, used as 
a fill character. 

Transmits answerback message. 

Generates a bell tone. 

Moves cursor to the left one 
character position, unless it 
is at the left margin, in which 
case no action occurs. 

Moves cursor to the next tab 
stop, or to the right margin if 
there are no more tab stops. 

Causes a line feed or a new 
line operation. (Refer to line 
feed/new line mode.) 

Processed as LF. 



Form Feed 

Carriage 
Return 

Shift Out 



FF 
CR 

SO 



014 
015 

016 



Processed as LF. 

Moves cursor to left margin on 
the current line. 

Selects Gl character set, as 
designated by a select 
character set sequence. 
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Name 
Shift In 



Device 
Control 1 

Device 
Control 3 



Character Octal 
Mnemonic Code 



Cancel 



Substitute 
Escape 

Delete 



SI 



DCl 



DC3 



CAN 



SUB 
ESC 

DEL 



017 



021 



023 



030 



032 
033 

177 



Function 

Selects G0 character set, as 
designated by a select 
character set sequence. 

Processed as XON. Causes 
transmitting characters. 

Processed as XOFF. Causes 
terminal to stop transmitting 
all characters except XOFF and 
XON. 

If received during an escape or 
control sequence, sequence is 
cancelled and the substitution 
character (s) is displayed. 

Processed as CAN. 

Processed as a sequence 
introducer . 

Ignored when received (not 
stored in input buffer) . 



ANSI COMPATIBLE SEQUENCES 



Set Mode 










Name 


Mnemonic 


Mode 


Sequence 


Line feed/new line 


LMN 


New line 


ESC 


[20h 


Cursor key 


DECCKM 


Application 


ESC 


[?lh 


ANSI/VT52 


DECANM 


ANSI 


N/A 




Column 


DECCOLM 


132 column 


ESC 


[?3h 


Scrolling 


DECSCLM 


Smooth 


ESC 


[?4h 


Screen 


DECSCNM 


Reverse 


ESC 


[?5h 


Origin 


DECOM 


Relative 


ESC 


[?6h 


Auto wrap 


DECAWM 


On 


ESC 


[?7h 


Auto repeat 


DECARM 


On 


ESC 


[?8h 


Interlace 


DECINLM 


On 


ESC 


[?9h 
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Reset Mode 










Name 


Mnemonic 


Mode 


Sequence 


Line feed/new line LMN 


Line feed 


ESC 


[201* 


Cursor key 


DECCKM 


Cursor 


ESC 


[?11* 


ANSI/VT52 


DECANM 


VT52 


ESC 


[?21* 


Column 


DECCOLM 


80 column 


ESC 


[?31* 


Scrolling 


DECSCLM 


Jump 


ESC 


[?41* 


Screen 


DECSCNM 


Normal 


ESC 


[?51* 


Origin 


DECOM 


Absolute 


ESC 


[?61* 


Auto wrap 


DECAWM 


Off 


ESC 


[?71* 


Auto repeat 


DECARM 


Off 


ESC 


[?81* 


Interlace 


DECINLM 


Off 


ESC 


[?91* 



I 

* The last character of the sequence is lowercase L (154o) . 
I ^ 

Cursor Key Codes Generated 

ANSI Characters Generated 
Reset Set 



Cursor 


(Cursor) 


(Applic 


Up 


ESC [ A 


ESC A 


Down 


ESC [ B 


ESC B 


right 


ESC [ C 


ESC C 


left 


ESC [ D 


ESC D 



Keypad Character Selection 

Name Mnemonic Sequence 



Alternate 
Numeric 



DECKPAM 
DECKPNM 



ESC = 
ESC > 
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Auxiliary Keypad Codes Generated 





VT52 


















Alternate 


















Keypad 


VT52 




ANSI 


ANSI 






Mode Off 


Alternate 


Numeric 


Alternate 




(Numeric 


Keypad 


Keypad 


Keypad 


Key 


Mode) 


Mode On 


Mode 


Mode 










ESC 


• 


P 





ESC 





p 


1 


1 


ESC 


? 


q 


1 


ESC 





q 


2 


2 


ESC 


? 


r 


2 


ESC 





r 


3 


3 


ESC 


? 


s 


3 


ESC 





s 


4 


4 


ESC 


• 


t 


4 


ESC 





t 


5 


5 


ESC 


? 


u 


5 


ESC 





u 


6 


6 


ESC 


? 


V 


6 


ESC 





V 


7 


7 


ESC 


? 


w 


7 


ESC 





w 


8 


8 


ESC 


• 


X 


8 


ESC 





X 


9 


9 


ESC 


? 


y 


9 


ESC 





y 


- (minus) 


- (minus) 


ESC 


7 


m 


- (minus) 


ESC 





m 


, (comma) 


, (comma) 


ESC 


? 


1 * 


, (comma) 


ESC 





1 * 


. (period) 


. (period) 


ESC 


? 


n 


. (period) 


ESC 





n 


ENTER 


Same as 
RETURN 


ESC 


? 


M 


Same as 
RETURN 


ESC 





M 


PFl 


ESC P 


ESC 


P 




ESC P 


ESC 





P 


PF2 


ESC Q 


ESC 


Q 




ESC Q 


ESC 





Q 


PF3 


ESC R 


ESC 


R 




ESC R 


ESC 





R 


PF4 


ESC S 


ESC 


S 




ESC S 


ESC 





s 



I 

* The last character of the sequence is lower case L (154o) . 
I ^ 

Select Character Sets (SCS) 



Character Set 



G0 Designator Gl Designator 



United Kingdom (UK) 
United States (USASCII) 
Special characters 
and line drawing set 
Alternate character ROM 
standard set 
Alternate character ROM 
special 

Name 

Single Shift 2 
Single Shift 3 



ESC ( A 


ESC ) A 


ESC ( B 


ESC ) B 


ESC ( 


ESC ) 


ESC ( 1 


ESC ) 1 


ESC ( 2 


ESC ) 2 


Mnemonic 


Sequence 


SS2 


ESC N 


SS3 


ESC 



NOTE; The following control characters are generated differently 
from previous DIGITAL terminals. 
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VT125 
Code Keys 

NUL CTRL — Space bar 
RS CTRL — ~ 
US CTRL — ? 



Previous Terminal Keys 

CTRL ~ § 
CTRL ~ " 
CTRL — 



Character Attributes 



Name 

Select 

Graphic 

Rendition 

Select 

Graphic 

Rendition 

Select 

Graphic 

Rendition 

Select 

Graphic 

Rendition 

select 

Graphic 

Rendition 



Mnemonic 

SGR 

SGR 
SGR 
SGR 



Sequence 

ESC [ m 

ESC [ 1 m 
ESC [ 4 m 
ESC [ 5 m 



Meaning 

Attributes off 

Bold or increased intensity 

Underline 

Blink 



SGR 



ESC [ 7 m Negative (reverse) image 



All other parameter values are ignored. 

Without the Advanced Video Option, a character can have only one 
attribute, and the attribute can only be underline or reverse. 
Either 4 or 7 can be used in the control sequence, but the VT125 
interprets the parameter as whichever attribute has been selected 
for the cursor in SET-UP. (See cursor selection in the SET-UP 
chapter . ) 



Scrolling Region 

Name 

Set top and bottom 
marg ins 



Mnemonic 

DECSTBM 



Sequence 

ESC [ Pt; Pb r 
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Cursor Movement commands 



up 

down 

forward (right) 
backward (left) 
position 
position (home) 
and vertical 



Name 

Cursor 

Cursor 

Cursor 

Cursor 

Cursor 

Cursor 

Horizontal 

position 

Horizontal and vertical 

position (home) 

Index 

Reverse index 

Next line 

Save cursor 

(and attributes) 

Restore cursor 

(and attributes) 



Mnemonic 


Sequence 




CUU 


ESC 




Pn 


A 


CUD 


ESC 




Pn 


B 


CUF 


ESC 




Pn 


C 


CUB 


ESC 




Pn 


D 


CUP 


ESC 




Pn; 


: PC H 


CUP 


ESC 




H 




HVP 


ESC 




PI; 


1 PC f 


HVP 


ESC 


[ 


f 




IND 


ESC 


D 






RI 


ESC 


M 






NEL 


ESC 


E 






DECSC 


ESC 


7 







DECRC 



ESC 8 



Tab Stops 

Name 

Horizontal tab set 
(at current column) 
Tabulation clear 
(at current column) 
Tabulation clear 
(at current column) 
Tabulation clear 
(all tabs) 

Line Attributes 



Mnemonic 


Sequence 


HTS 


ESC H 


TBC 


ESC [ g 


TBC 


ESC [ g 


TBC 


ESC [ 3 g 



Name 



Mnemonic 



Sequence 



Double-height top half 
Double-height bottom half 
Single-width single-height 
Double-width single-height 



DECDHL 
DECDHL 
DECSWL 
DECDWL 



ESC # 3 
ESC # 4 
ESC # 5 
ESC # 6 
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Erasing 

Name 

Erase in line 

(cursor to end of line) 

Erase in line 

(cursor to end of line) 

Erase in line 

(beginning of line to cursor) 

Erase in line 

(entire line containing cursor) 

Erase in display 

(cursor to end of screen) 

Erase in display 

(cursor to end of screen) 

Erase in display 

(beginning of screen to cursor) 

Erase in display 

(entire screen) 

Reports 

Name 

Device status report 
(request status of VT125) 
Response: 

Terminal OK 

Terminal not OK 

Device status report 
(request cursor position) 
Report cursor position 

Device attributes 
(what are you) 
Device attributes 
(what are you) 
Identify terminal 
(what are you) 
Device attributes 

Response: VT125 



Mnemonic 


Sequence 


EL 


ESC 




K 


EL 


ESC 




K 


EL 


ESC 




1 K 


EL 


ESC 




2 K 


EK 


ESC 




J 


ED 


ESC 




J 


ED 


ESC 




1 J 


ED 


ESC 




2 J 



Mnemonic 


Sequence 


DSR 


ESC 


[5n 


DSR 


ESC 


[0n 


DSR 


ESC 


[3n 


DSR 


ESC 


[6n 


CPR 


ESC 


[Pi; PC R 


DA 


ESC 


[c 


DA 


ESC 


[0C 


DECID 


ESC 


z 



DA 



ESC [?12; <VT100 feature 
<VT125 features>; 
<VT125 ROM version>c 
<VT100> 5 = No AVO 

7 = AVO 
<VT125> 1 = Printer 

= No Printer 
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Reset 

Name 

Reset to initial state 

Test and Adjustments 

Name 

Screen alignment display 
(fill screen with "Es") 

Invoke confidence test 
(power-up test) 

VT125 Self-test Format: ESC 

PS = 1 

Ps = 2 

PS = 3 



Mnemonic 

RIS 



Sequence 
ESC c 



Mnemonic Sequence 

DECALN ESC # 8 



DECTST 



ESC [ 4 ; 1 y 



PS 
PS 



4 
5 



PS = 9 



Keyboard LEDs (Indicators) 



Name 

Load LEDs 
(all off) 

Load LEDs 
(LI on) 

Load LEDs 
(L2 on) 

Load LEDs 
(L3 on) 

Load LEDs 
(L4 on) 



Mnemonic 

DECLL 

DECLL 
DECLL 
DECLL 



DECLL 



[ 4 ; 1 ; PS . . . ; PS y 

VT125 Power up test 

VT125 Computer Port Data 
loopback test 

VT125 Auxiliary Port Data 
loopback test 

VT125 Display test 

VT125 Video Bit Map Memory 
test 

Repeat any selected tests 
continuously until power off or 
failure 



Sequence 

ESC [ q 

ESC [ 1 q 

ESC [ 2 q 

ESC [ 3 q 

ESC [ 4 q 
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VT52 COMPATIBLE MODE 

Set and Reset Modes Sequence 

Enter ANSI mode ESC < 

Keypad Character Selection 

Name 



Enter alternate keypad mode 
Exit alternate keypad mode 

Character Sets 

Name 

Special graphics character set* 
Select US/UK character set 
(as determined by US/UK 
character SET-UP feature) 

Cursor Position 

Name 

Cursor up+ 

Cursor down+ 

Cursor right+ 

Cursor left+ 

Cursor to home 

Direct cursor address=|= 

Reverse line feed 

Erasing 

Name 

Erase to end of line 
Erase to end of screen 

Reports 

Name 

Identify (what are you) 
Response: VT100 



Sequence 

ESC = 
ESC > 



Sequence 

ESC F 
ESC G 



Sequence 



ESC A 
ESC B 
ESC C 
ESC D 
ESC H 
ESC Y 
ESC I 



PI PC 



Sequence 

ESC K 
ESC J 



Sequence 

ESC Z 
ESC / Z 



* Same as special character and line drawing set in ANSI mode. 
+ Same when sent from the terminal. 

4 Line and column numbers for direct cursor address are single 
character codes whose values are the desired number plus ^l.^^^,. 
Line and column numbers start at one. 
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ReGIS Command Summary 



V 



[] 

[<position>] 

<pixel vector> or <pv> 

(B) 

(S) 

(E) 

(W(<temporary writing controls>)) 

Position Command Summary 



Reset pattern memory 

Move to <position> 

Move <multiplier> pixels 
in <pv> direction 

Save current location 

Save dummy location 

Move to last saved location 
P(W(M<multiplier>) ) 



[] 

[<position>] 

<pixel vector> or <pv> 

(B) 
(S) 
(E) 

(W(<temporary writing controls>) 
Vector Command Summary 



Draw dot at current position 

Draw vector to <position> 

Draw <multiplier> pixels 
in <pv> direction 

Save current position 

Save dummy position 

Draw to last saved position 

V(W(M<multiplier>) ) 



D-lO 



[<position>] 



(C) <position>] 



(A<degrees>) [position>] 



(A<degrees>C) [position>] 



(B) [position] . . . [position] (E) 

(S) [] [position] . . . [position] [] (E) 



Circle with Center at Curr 
Position, Circumference at 
<position> 

Circle with Center at 
<position>. Circumference 
at Current Position 

Arc with Center at Current 
Position, starting at 
<position> for <degrees> 

Arc with Center at 
<position>, starting at 
current position for 
<degrees> 

Bounded (closed) curve 
Unbounded (open) curve 



(W(temporary writing controls)) 

Curve Command Summary 

(S <size number>) 

(H <height>) 

[<spacing>] 

(S [<width in pixels> ,<height in pixels>] ) 

(M [<width pixel mul tiplier> ,<height pixel multiplier>] ) 

(D <direction angle>) 

(D <string tilt> S <size> D <char tilt>) 

(T <italic degrees>) 

(A <pattern set number>) 

((B) <temporary attributes block> (E) ) 

(W(temporary writing controls)) 

Text Command Summary 
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W { (C) 
(E) 

(R) 
(V) 

(F <foreground planes>) 



(I 



or 
(I 



or 


(D) ) 


1 


(R) ) 


2 


(G) ) 


3 


(B) ) 




(C) ) 




(Y) ) 




(M) ) 




(W) ) 



(H <hue angle> 
L <lightness percent> 
S <saturation percent>)) 



(M <multiplier>) 

(N 1) 

(N 0) 

(S 1) 

(S 0) 

(S [, shading reference]) 

(S 'shading character') 

(P <binary pattern>) 

(P <pattern number>) 

(P (M <pattern multiplier>) ) 



(W<i> (P<j>,N<k>) ) 



Complement 




Erase 




Replace 




Overlay 




= no planes 




1 = plane 1 




2 = plane 2 




3 = planes 1 and 


2 


Foreground 




Intensity: 




Dark or 


Dark 


Dim grey 


Red 


Light grey 


Green 


White 


Blue 




Cylan 




Yellow 




Magenta 




White 



= negative on 
= negative off 

= shading on 
= shading off 



Enter pattern 
Use VT125 pattern 



Custom writing control 
Writing Controls Summary 
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<pixel vector> 

[position>] 

(A [<position>] [<posi tion>] ) 



(E) 

(H [<position>] [<position>] 

(H(P[<position>] ) ) 



(I 


or 


(D) ) 




1 


(R) ) 




2 


(G) ) 




3 


(B) ) 

(C) ) 
(Y) ) 
(M) ) 
(W) ) 



or 
(I 



(H <hue angle> 
L <lightness percent> 
S <saturation percent>) ) 



S(M<n> (<mono HLS>) (A<color HLS>)) 



(S <scale>) 

(S (X<scale>Y<scale>) ) 

(T <ticks>) 



Scroll 

Display 
addressing 

Erase screen 

Hard copy (corner positions 

optional) 

Set hard copy offset 



Background 
Intensity : 
Dark 

Dim grey 
Light grey 
White 



Output 
Mapping 



Time Delay 
Screen Controls Summary 



or Dark 
Red 



Green 

Blue 

Cyan 

Yellow 

Magenta 

White 
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@ { . } Clear all macrographs 

{ } 

{ :keyletter character_str ing @; } Define macrograph 



{ 

{ keyletter 



L { (A<integer>) 
{ 

{ (A"<name>") 
{ 

{ "<ascii char>" <hex pair> 

{ <hex pair>; 



R 



(L) 

(M(<keyletter>) 

(M(=)) 

"<f ree>,<total>" 

(P) 



} 

} Invoke macrograph 

Macrograph Command Summary 

Select for loading 

Give name to set 

Load cell 

Character Cell Control Summary 
Set selected for loading 
Contents of macrograph 
Use of storage 
Reply to use 
Cursor position 

Report Command Summary 
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APPENDIX E 
ANSI CODE EXTENSION TECHNIQUES 



GENERAL 

This section describes the ANSI code extension techniques as 
defined in ANSI standards X3. 41-1974 and X3. 64-1979 (ISO 2022 and 
6429). (See the Accessories chapter for ANSI standards ordering 
information.) The description is based on the functions used in 
the VT100 and LA120 families of terminals. There are many special 
cases and details in the specifications that are not described 
here. 

CLASSES OF CHARACTERS 

The ANSI system is based on the use of classes of characters for 
specific purposes. The classes are determined by the characters' 
positions in the ASCII table (Figure E-1) . This table and the ANSI 
system can work for either a 7-bit or an 8-bit character 
environment. Current terminals support only 7-bit characters. 

CONTROL FUNCTIONS 

All control characters and groups of characters (strings) that 
control the operation of the terminal and are not displayed on the 
screen are part of the system called control functions. Not all 
control functions perform an action in every device that 
understands ANSI, but each device can understand all control 
functions and discard any that do not apply to it. Therefore, each 
device is said to perform a subset of the ANSI functions. 

COMPLIANCE WITH ANSI 

Because different devices use different subsets, compliance with 
ANSI does not mean compatibility between devices. Compliance only 
means that a given action, if defined in the ANSI standard, is 
caused by the same control function in all devices. If an ANSI 
device does not perform an action that has a control function 
defined in the ANSI standard, it cannot use that control function 
for any other purpose. 

For example, ESC c is Reset for devices meeting ANSI and having a 
remote reset function. Even if a device does not have this 
function, it still may not use ESC c for any other purpose. ESC 7 
(Save Cursor Position) , however, is a private sequence and may be 
used for other purposes by devices from other manufacturers. But 
within DEC, each private sequence is registered in an internal 
standard so that all DEC products use each sequence for only one 
purpose . 
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B7 
BE 


B5 
i 









1 



1 





1 
1 


1 




1 

1 


1 

1 



1 
1 

1 


BITS 


COLUMN 




1 


2 


3 


4 


5 


6 


7 


B4 B3 B2 B1 


ROW 








NUL 







OLE 


20 
16 

10 


SP 


40 
32 
20 





60 
48 
30 


@ 


100 
64 
40 


P 


120 
80 
50 


\ 


140 
96 

60 


P 


160 
112 
70 


1 


1 


SOH 


1 

1 
1 


DC1 

(XON) 


21 
17 
11 


! 


41 
33 
21 


1 


61 
49 

31 


A 


101 
65 
41 


Q 


121 
81 
51 


a 


141 
97 
61 


q 


161 
113 
71 


10 


2 


STX 


2 
2 
2 


DC2 


22 
18 
12 


II 


42 
34 
22 


2 


62 
50 
32 


B 


102 
66 
42 


R 


122 
82 
52 


b 


142 
98 
62 


r 


162 
114 
72 


11 


3 


ETX 


3 
3 
3 


DCS 

(XOFF) 


23 
19 
13 


# 


43 
35 
23 


3 


53 
51 
33 


C 


103 
67 
43 


S 


123 
83 
53 


c 


143 
99 
63 


s 


163 
115 
73 


1 


4 


EOT 


4 

4 
4 


DC4 


24 
20 
14 


$ 


44 
36 
24 


4 


64 
B2 
34 


D 


104 
68 
44 


T 


124 
84 
54 


d 


144 
100 
64 


t 


1B4 
116 
74 


10 1 


5 


ENQ 


5 

5 
5 


NAK 


25 
21 
15 


% 


45 
37 
25 


5 


65 
53 
35 


E 


105 
69 
45 


U 


125 
85 
55 


e 


146 
101 
65 


u 


165 
117 
75 


110 


6 


ACK 


6 
6 
6 


SYN 


26 
22 

IB 


& 


46 
38 
26 


6 


66 
54 
36 


F 


106 
70 

46 


V 


126 
86 
56 


f 


146 
102 
66 


V 


166 
118 
76 


111 


7 


BEL 


7 
7 
7 


ETB 


27 
23 

17 


/ 


47 
39 
27 


7 


67 
55 
37 


G 


107 
71 
47 


w 


127 
87 
57 


g 


147 
103 
67 


w 


167 

119 

77 


10 


8 


BS 


10 
8 
8 


CAN 


30 
24 
18 


( 


50 
40 

28 


8 


70 
56 
38 


H 


110 
72 
48 


X 


130 
88 
58 


h 


ISO 
104 
68 


X 


170 
120 
78 


10 1 


9 


HT 


11 
9 
9 


EM 


31 
25 

19 


) 


51 
41 
29 


9 


71 
57 
39 


I 


111 
73 
49 


Y 


131 
89 
59 


' 


151 
105 
69 


y 


171 
121 
79 


10 10 


10 


LF 


12 
10 
A 


SUB 


32 
26 
1A 


* 


52 
42 
2A 


" 


72 

58 
3A 


J 


112 
74 
4A 


z 


132 
90 
5A 


j 


152 
106 
6A 


z 


172 
122 

7A 


10 11 


11 


VT 


13 
11 
B 


ESC 


33 
27 

IB 


+ 


53 
43 
2B 


1 


73 
69 
3B 


K 


113 
75 
48 


C 


133 
91 
58 


k 


153 
107 
6B 


{ 


173 
123 
7B 


110 


12 


FF 


14 
12 
C 


FS 


34 
28 
1C 


» 


54 
44 
2C 


< 


74 
60 
3C 


L 


114 
76 
4C 


\ 


134 
92 
5C 


1 


154 
108 
6C 


1 


174 
124 
7C 


110 1 


13 


CR 


15 
13 
D 


GS 


35 
29 
ID 


- 


65 
45 
2D 


s 


75 
61 
3D 


M 


115 
77 
4D 


] 


135 
93 

BD 


m 


155 
109 
6D 


> 


175 
125 
7D 


1110 


14 


SO 


16 
14 
E 


RS 


36 
30 
IE 


■ 


56 
46 
2E 


> 


76 
62 

3E 


N 


116 
78 
4E 


A 


135 
94 
6E 


n 


156 

110 
6E 


-N^ 


176 
126 
7E 


1111 


15 


SI 


17 
15 

F 


US 


37 

31 
IF 


/ 


57 
47 
2F 


? 


77 
63 
3F 


O 


117 
79 
4F 


— 


137 
95 

5F 


o 


157 
111 

6F 


DEL 


177 
127 
7F 



KEY 



ASCII CHARACTER 




33 


OCTAL 


27 


DECIMAL 


IB 


HEX 



Figure E-1 ASCII Table 
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CONTROL CHARACTERS 

A control character is a single character which, when received by 
the terminal, starts, modifies, or stops a control function. The 
value of a control character is in the octal range of through 37 
and 177. 

Chapter 4 of this manual explains the control characters that are 
understood by the terminal. All other control character codes are 
ignored by the terminal. 

This terminal can perform some actions that are usually caused by 
control character codes from the 8-bit ASCII environment, which 
this terminal does not understand. It does this by understanding 
certain combinations of 7-bit codes, which other sections of this 
appendix will explain. 

ESCAPE SEQUENCES 

One control character causes the function of waiting for more 
characters that are not in the control character numerical range. 
This is the Escape or ESC character (033(8)). This character is 
defined by ANSI standard X3. 4-1977 as "Introducer". If the 
terminal receives this character, it waits for more characters to 
follow within certain numerical ranges to form an Escape Sequence 
as defined in ANSI X3. 41-1974 and ANSI X3. 64-1979. 

The format of an Escape Sequence is: 

ESC I. ..I F 

033 040-057 060-176 

Escape Intermediate Final 
Sequence Characters Character 
Introducer (Any number (One code) 

of codes - or more) 

If following characters are in the range 040 — 057(8) (column 2), 
they are called "Intermediate Characters". The device accepts and 
stores them. 

If a following character is in the range 060 — 176(8) (columns 3 
to 7), it is a "Final Character". The final character signals the 
end of an Escape Sequence which the device then analyzes. Final 
characters from column 3 are for private control functions for use 
in a specific device. Final characters from columns 4 — 7 are 
for ANSI standardized control functions. 

Some two character escape sequences perform the same actions as 
some 8-bit single character control functions. The VT100 family 
supports six of these. ESC [ is CSI (see next section) ; ESC D is 
IND, ESC E is NEL, and ESC M is RI (see Cursor Positioning); ESC N 
is SS2 and ESC is SS3 (see Character Sets and Selection) . The 
VT125 also supports ESC P which is DCS and ESC \ which is ST (see 
Communication and Graphic Protocol Controls.) 

The intermediate and final characters are taken together to define 
the function of the sequence. Then the device performs the action 
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and accepts more data. If the action defined by the escape 
sequence does not apply to the device, the device ignores the 
complete sequence and accepts more data. 



Escape sequence examples (all examples have added 
characters to make them easier to read): 



spaces between 



ESC 


H 




ESC 


( 


B 


ESC 


# 


6 


ESC 


( 






= Set Tab at active position 

= Designate G0 Character Set as ASCII 

= Double Width Line. (VT100) (6 = DEC Private) 

= Designate G0 character set as DEC private 

Special Graphics character set (0 = private) 



Example Sequence: Designate 
Character Set (SCS) = ESC ( B 



G0 Character Set as ASCII Select 



ESC 



Sequence 
( 



Escape 
Character 



B 



Final 
Character 



Intermediate 
Character 



Octal Representation 
of Sequence 
033 050 102 



Escape 
Character 



Final 
Character 



Intermediate 
Character 



CONTROL SEQUENCES 

The string ESC [ is a two character escape sequence and represents 
the 8-bit control character CSI. This is "Control Sequence 
Introducer" and it precedes all control sequences in the same way 
that the ESC "Introducer" precedes all escape sequences. ESC [ 
allows the extended functions of the 8-bit control sequence 
environment to work in the 7-bit environment of current terminals. 
The control sequence is defined in ANSI X3. 64-1979. 



The format of a Control Sequence is 



CSI 

033 133 

Control 

Sequence 

Introducer 



P P 

060-077 
Column 3 
Parameter 
(0 or more 
codes) 



I. . .1 
040-057 
Column 2 
Intermediate 
(0 or more 
codes) 



F 

100-176 
Column 4-7 
Final 
(One code) 



A device parses this sequence without considering its meaning. 
That is, characters are stored in classes only according to their 
range of values. Then, the device interprets these characters by 
value according to their classes. The intermediate and final 
characters are taken together to define the function of the 
sequence. In the range of final characters, 100 — 157 (columns 4 
-- 6) are reserved for standardization by ANSI, while 160 — 176 
(column 7) are reserved for private use. 
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Parameters 

The parameters modify the action or interpretation of the 
function. The parameters are from column 3 and may be any 
combination of the characters 0-9 (060-071) with each parameter 
separated from the others by ; (073) . (The other characters in 
column 3 are : (072) which is reserved, and < = >? (074 — 077) 
which are assigned for private use and mean that the following 
parameters have a private interpretation.) Any leading zero in a 
parameter is ignored; this also applies to the parameter value 0. 
Therefore a sequence with no parameter is the same as a sequence 
with a parameter of and both are understood as having the 
default value for that parameter in the sequence. 

A single parameter that modifies the action of a control function 
is called a numeric parameter and has the abbreviation "Pn". 
(Example: Cursor Up, ESC [ Pn A, where Pn is number of lines.) A 
parameter that defines the action of a control function by 
selecting from a list of possible actions is called a selective 
parameter and has the abbreviation "Ps". (Example: Set Mode, ESC [ 
Ps h, where Ps selects the mode to be set.) Control functions that 
have selective parameters can accept multiple parameters to allow 
several actions to be commanded with a single control function. 

A sequence with multiple parameters has several "Ps" separated by 
";" characters (Ps;Ps;Ps). This is called a parameter string. If 
the parameters apply to the screen image, their abbreviations 
indicate this: Pt;Pb for top and bottom, and Pl;Pc for line and 
column. 

Character 077 (?) at the beginning of a parameter string means 
that the parameters are private parameters. That means the Control 
Sequence is standardized but the function that it controls is 
private. (Ex: Set and Reset Mode control functions.) Some control 
functions are defined to have a default value for a parameter. The 
default value is assumed when no parameter character is included 
in a sequence. 

Examples with octal equivalents: 

ESC [ 3 g = Clear all tabs 
033 133 063 147 

ESC [ g = Clear tab at active position (default value = 0) 
033 133 147 

ESC [ 16 ; 32 u = Set tabs at columns 16,32 (LA120) (u = 
private) 

033 133 061 066 073 063 062 165 

ESC [ ? 2 ; 3 h = Set modes 2 and 3 (? = private) 
033 133 077 062 073 063 150 

ESC [ 20 h = Set Linefeed/New Line mode (parameter = 20) 
033 133 062 060 150 
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ESC [ 2 ; 1 y = Run Power-up selftest (VT100) (y = private) 
033 133 062 073 061 171 



NOTE: There 


are no examples 


of control 


sequences 


with 


intermediate 


characters 


because 


current terminals 


do 


not h 


ave 


any control 


functions in that f 


orma t . 


Howeve r , 


new 


soft 


wa r e 


written to 


understand 


the ANSI 


syntax 


should be a 


ble 


to parse sequences with 


intermediate characters. Future Digital 


terminal 


products may use 



intermediate characters. 

Example Sequence: Control sequence to set modes for 132 column 
mode, smooth scrolling, and reverse screen. ESC[?3;4;5h 



Indicates Private 
Parameter 

I 
ESC[ ? 3 



CSI 



Delimiters 
5 h 



'Parameters- 



Final 
Character 



— Parameter String-' 
Indicates Private 



Parameter 



Delimiters 



033 133 077 063 073 064 073 065 150 



CSI 



Parameters 



^Parameter String- 



Final 
Character 



Alternate sequences that will do the same thing: 
ESC[?3hESC[?4hESC[?5h 



ESC[?03;004;5h 



(Parameters can be split into 
separate control sequences.) 

(Leading zeroes are ignored.) 



ERROR RECOVERY 

On the problem of incorrect control functions, the ANSI standards 
only say that error recovery techniques are not defined. These 
errors include out of range parameters, invalid control functions, 
and control characters embedded in control functions. The VT100 
family recovers from errors with as much correct function as 
possible rather than discard any error. For example, if the VT100 
receives a sequence asking it to move the cursor beyond the right 
margin, it moves the cursor to the right margin. In the LA120, a 
command to move beyond the right margin is ignored and the active 
position stays unchanged. 
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If a control character appears within a sequence, the VT100 
performs the function of the control character (for example,^ a 
carriage return) as if it had been received before the beginning 
of the sequence. However, CAN and SUB appearing in a sequence stop 
the processing of the sequence at that point. The terminal returns 
to regular character processing and displays any characters 
remaining in the sequence. 

A control function that is unrecognizable is ignored. Unsupported 
control functions (any apparently valid sequences that are not 
listed in this book) are generally ignored but may produce 
unpredictable responses. 

NOTE: In the past, some programmers have used error condition 
actions in a given terminal to get the actions they wanted. This 
is not a safe practice in the ANSI environment because there is no 
guarantee that different ANSI-complying terminals will handle an 
error the same way. This would limit the transportability of code. 

CHARACTER SETS AND SELECTION 
G0, Gl, C0, CI Character Sets 

The ANSI and ISO standards provide extensions to the range of 
graphic and control character sets in a terminal, in addition to 
the extension of control functions described in the preceding 
section . 

A typical terminal transmits and receives the 7-bit ASCII 
character set. This character set has an eight column chart, and 
in it, columns and 1 .are control characters, while the rest of 
the set is graphics (except SP and DEL) . SP (space) and DEL 
(delete) are always the same control characters with the same 
codes regardless of character set and so they are independent of 
character set selection. 

The ANSI standards provide a system to allow the use of larger 
character sets in any terminal, without increasing the number of 
bits that the terminal must use to describe each unique character. 
Consider Figure E-2, the 8-bit ASCII chart. 

The left side of the figure represents the familiar 7-bit ASCII 
character set. G0 and Gl are labels that are attached to character 
sets to indicate how the sets can be substituted for each other. 
The ANSI word for this is Designate. There are escape sequences 
that designate character sets as either G0 or Gl. The control 
characters Shift Out (SO (016)) and Shift In (SI (017)), when 
included with 7-bit ASCII data, switch the display of a terminal 
from one character set to the other. The ANSI word for this is 
Invoke. 

In the VT100, any character set whose display patterns are stored 
in the terminal can become either G0 or Gl. SO always invokes the 
Gl set and SI invokes the G0 set. Sets can be invoked or 
designated at any time and in any order. Some character sets have 
been internationally registered, while others are private for use 
in a given terminal. 
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ROW 

- 

1 _ 

2 _ 

3. 

4 _ 

5 . 
6 

7 
10 
11 

12 - 
13 
14 
15 
16 _ 
17 



COLUMN 

1 2 3 4 5 6 

J I L_ 



7 10 1112 13 14 15 16 17 
-J 1- 



CO 
SET 



SP 



P 
GO 
SET 



^^ 



[ i- 
\ 



M 
N 




DCS 
CI 
SET 



IND 

NEL 



-> CSI 
ST 



Rl 

I SS2 

DELSS3 
I L 



G1 
SET 



CO, CI = CONTROL CHARACTER SETS 
GO, G1 = GRAPHIC CHARACTER SETS 
DCS, ST = VT125, VK100ONLY 



Figure E-2 8-Bit ASCII Chart 



•ESC (A ►GO SET 1 (UK| 

-ESC(B »-G0 SET 2 (ASCII) 

-ESC(0 ►GO SET 3 (SPECIAL GRAPHICS) 

►GO SET 4 

►GO SET n 



SO 



-ESCIA ►Gl SET 1 (UK) 

•ESOB ►Gl SET 2 (ASCII) 

• ESC )0 ►Gl SET 3 (SPECIAL GRAPHICS) 

► Gl SET 4 

►Gl SET n 



Figure E-3 Illustration of Shift-Out and 
Shift-In 
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In the VT100, the C0 control character set is normally available. 
There are escape sequences that cause the actions of single 
control functions of the CI set on a one time basis. The ESC 
character followed by a final character from columns 4 or 5 causes 
the action of a control function that is also caused by a single 
8-bit character in the CI set. Figure E-2 shows how ESC [ causes 
the CSI function and ESC D causes the IND function from the CI 
set. The other CI characters that are supported in the VT100 
family of terminals are also shown. 

Figure E-3 shows a schematic representation of the Shift-Out and 
Shift-In concept. This figure shows how G0 and Gl character sets 
are designated by escape sequences and invoked by the SO and SI 
characters . 
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APPENDIX F 
CREATING COMPATIBLE ReGIS 



This appendix lists the differences in implementation of ReGIS 
between the VT125 and the VK100 (GIGI). Use this information to 
create ReGIS images if you must use the same source on both 
terminals. 



1.0 

Use 



COMPATIBLE REGIS SUMMARY 



Four colors only; use 
S(M...) if not D, B, R, G. 

HLS or RGB in S(I...) and W(I...) 



S(I... ,E) . 
W(V/R/E) , W(N. . .) . 
W(I,C) . 
S(H[0,yl] [767, y2]) . 

S[<0 to 767>,<0 to 511>] . 

2000 or less characters of 
macrographs . 



rather than . . . 

More than four colors. 

Numeric arguments to W(I...) 
and S(I) . 

S(E,I.. .) . 

W(F.. .) , W(W...) . 

W(C) . 

S(H[xl,yl] [x2,y2]) or 
S(H[,yl] [,y2]) . 

S[ ] with negative or 

overrange numbers. 

More than 2000 characters of 

macrographs. 



1.1 
VT125 



COMMAND DIFFERENCE SUMMARY 



- S(M...) selects color. 
S(I...) and W(I...) select one of 
the colors specified by S(M...), 
based on a closest-match algorithm. 

- HLS color specifiers to S(M...), 
S(I...), and W(I...) specify one 
of 64 colors. 



VK100 

- S(I.. .) and W(I.. .) 
explicitly select colors 



- HLS specifiers select 
one of 8 colors. 
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VT125 



VKIOO 



- S(In) and W(In) accept values 
of to 3 for n. 

- No S(W...) . 



- S(S...) controls screen 
scaling (zoom) . 

- S(H[xl,yl] [x2,y2]) will hardcopy 
a specified rectangle from 

xl,yl to x2,y2. 

- S(H(P[x,y])) positions the 
hardcopy device at x,y before 
performing the hardcopy. 
Default value is [50,0]. 

- S(H...) performs scaling 
(zoom) on hardcopy if selected. 

- No W(I) (no argument to I). 



- W(F...) selects planes to be 
written. 

- W(C) writing complements each 
plane individually, thus it may 
change the color. 



- No W(A...) . 



- No locator mode; could 
be emulated in software. 



- S(In) and W(In) accept 
values of to 7 for n. 

- S(W...) controls erase 
write operations. 

- No S(S.. .) . 



- S(H...) only uses Y 
values of range. 



- No S(H(P...)), defaults 
to [50,0]. 



- No scaling. 



- W(I) allows writing of 
only the foreground/ 
background plane, leaving 
the color unchanged. 

- No W(F.. .) . 



- W(C) writing complements 
only the foreground/ 
background plane, writing 
an explicit new color or 
leaving the color 
unchanged . 

- W(An) selects "blink" 
attribute for writing. 

- R(P(I. ..)) allows 
interactive positioning of 
a "locator" cursor. Also 
accessable by a keyboard 
command. 



- At least 5000 characters of 
macrograph storage. 

- Concurrent text and graphics 
can be displayed by using 
"DCS 2 p" to enter graphics 
mode. 



- At least 2000 characters 
of macrograph storage. 

- SET-UP mode "GD" allows 
the last line of graphics 
commands to be displayed 
concurrently with 
graphics. 
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VT125 



VKIOO 



- REGIS command parsing is 
not affected by "DCS p" and 
"ST". Using "DCS 1 p" will 
reset REGIS to top comand level. 

- Graphics cursor cannot be disabled; 
it is present whenever the VT125 

is processing REGIS graphics 
commands. 



- "DCS p" resets REGIS to 
top command level. 



- SET-UP mode "VC" selects 
whether the graphics 
cursor is displayed. 



- Hardcopy output can be 
directed to the host port 
using the "Media Copy" control 
sequence. 

- Hardcopy output is enclosed 

in a single "DCS q"/"ST" sequence, 
using the DECwriter control 
commands . 



- Hardcopy output can be 
directed to the liost port 
by swapping the cables. 



- Hardcopy output is 
enclosed in "DCS q" on a 
line-by-line basis. 



- Hardcopy image data sent to 
the VT125 will be displayed as if 
the VT125 was a hardcopy device. 



- Hardcopy data sent to 
the VK100 is ignored. 
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APPENDIX G 
THE HLS COLOR SYSTEM IN THE VT125 



The display port for the external color monitor is driven by a six 
bit output map, providing 2 bits (4 levels) of intensity for each 
primary color: red, green, and blue. This section describes the 
general allocation of RGB specifiers based on HLS descriptors. 

The HLS double cone model (Figure G-1) is divided into seven 
layers linearly spaced along the lightness axis. If lightness 
is not specified in a color descriptor, it defaults to 50%, the 
layer with the greatest variety of colors. The extreme layers, 
below 14% and above 86%, map to black and white respectively, 
regardless of H and S. 

Each non-extreme lightness level is divided into one to three 
concentric rings based on the saturation parameter. If saturation 
is 0%, then the color specifier must map to one of four gray 
levels based on the lightness parameter. If saturation is not 
specified, it defaults to 100%. 

Each non-gray lightness/saturation ring is divided into from three 
to twelve segments based on hue. Hue has no default. If not 
specified, then the lightness parameter again defines a gray 
level. By these defaults, the null specifier maps to the medium 
gray level in the VT125. 

Percentage values for L and S of less than or more than 100 map 
to 0% and 100% respectively. Hue is computed modulo 360. 

The following table summarizes the color allocations derived from 
the above rules. 

lightness saturation color range 

to 14 any black; 

15 to 28 any >0 three primaries and simple secondaries; 

29 to 42 1 to 49 three light primaries; 

50 to 100 nine shades, including middle 
lightness pure primaries; 
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DIAMETER IS 

PROPORTIONAL 

TO NUMBER OF HUES 

THAT CAN BE 

DISPLAYED. 



Figure G-1 



HLS Double Cone 
Color Model 
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lightness saturation color range 

43 to 57 1 to 33 three unsaturated secondaries; 

34 to 66 nine shades, including less saturated 

primaries; 
67 to 100 twelve shades, including the brightest 

pure primaries, almost brightest pure 

secondaries, and the six shades in 

between; 

58 to 71 1 to 49 three unsaturated primaries; 

50 to 100 nine shades, including the brightest 
pure secondaries; 

72 to 85 1 to 49 three very unsaturated primaries; 
50 to 100 three less than fully saturated 
secondaries; 

86 to 100 any white; 

The primaries are red, green, and blue. The secondaries are 
yellow, cyan, and magenta. 

When saturation is 0% or hue is unspecified, lightness values to 
24, 25 to 49, 50 to 74, and 75 to 100 map to black, dim gray, 
brighter gray, and white respectively. 
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APPENDIX H 
ReGIS COMMAND LISTINGS 



This appendix lists the ReGIS commands used to create art for 
this book. 



FIGURE 5-3 

p[200, 100] (b) [+15,-15] f [200,100]' p(e) v (b) [200 , 200] (b) 

p(b) [+10,-15] f [200,200]' p(e) 

v[300,400] p(b) [+5] f [300,400]' p(e) v[400,300] 

p(b) [ + 5,-5] t' [400,300]' p(e) v(e)c[ + 5] 

v[100,50] p(b) [-85,-10] t' [100,50]' p{e) v(e)c[+10] 

p[100,430]t(sl) "p[200,100] v (b) [200 , 200] (b) v[300,400] 

v[400,300] v(e)c[+5] v[100,50] v(e)c[+10]" 

FIGURE 5-4 

p[384,240] c[+100,+50] c[+3] 

p(b) [310,193] t'CURRENT POSITION' 

p[285,213] t' (START END POSITION)' 

p(e,b) [-40,+5] t' [384,240]' 

p(e,b) [+100,+50] c[+3] p[+10] t' [+100 ,+50] ' 

p[300,390] t"p[384,240] c[+100,+50]" 

FIGURE 5-5 

p[284,300] (b) c[+3] c (c) [+100 ,-100] 

p(e,b) [-90] t' [284,300] ' 

p(e,b) [-150, +20] t'CURRENT POSITION' 

p{e,b) [-180,+40] t' (START END POSITION)' 

p(e) [+100,-100] c[+3] p[-50,-25] t ' [+100 , -100] ' 

p[240,400] t"p[284,300] c(c) [+100,-100]" 
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FIGURE 5-6 

;'Set defaults for text, writing commands' 

dO,sl) w(v,pl) 

Set current position, mark and label it, add text above and below it' 
p[384,240] c[+3] p (b) [-40 , -50 ] t'CURRENT' p{e ,b) [-40 , -30] t'POSITION' 
p(e,b) [ + 5,-12] t' [384,240]' 
p(e,b) [-50,+10] f (START END' p(e ,b) [-40 , +30 ] t'POSITION)' p(e) 

Draw arc, mark and label endpoints' 

Endpoint positions determined by temporarily embedding' 

other commands including r(p) ' 
c(al40) [+100,-100] p[+100,-100] c[+3] p[+5,-5](b) t' [+100 ,-100] ' 
p(e) [,+20] f ([489,135]) ' 
p[242,253] c[+3] p[-85,+5] t' [242,253]' 

Draw arc with pattern to show drawing direction,' 

Leave gap for text' 
p[384,240] [ + 90,-90] w(p4) c (aVOc) [384 , 240] w(p0) c (a20c) [384 , 240] 
p(b) p[+5,-15] w(v) t'140 degrees' p(e) 
w(p4) c(a50c) [384,240] p[384,240] p[+90 , -90 ] [ + 7 ,-2] 
; 'Vs drawn at endpoints' 
w(pl) t(d225,s0) 'V p[256, 251] [-5,-10] t(dO,sl)'V' 

Print basic command' 
p[240,350] t'p[384,240] c (al40) [+100 , -100] ' 

FIGURE 5-7 

; 'Mark and label radius of arc, move to start of arc' 

p[384,140] c[+3] p(b) [-40,-30] t ( si) ' [-100 , -100] ' p( e) [+100 , +100] 

;'Mark and label current position' 

c[+3] p(b,b) [+5,-20] t'START POSITION' 

p(e,b) [ + 5] t' (CURRENT POSITION)' p(e) 

; 'Draw arc ' 

c(a-90c) [-100,-100] 

; 'Mark and label end position' 

c[+3] p(b) [-125,-20] t' END POSITION' p(e,b)[-125] t' (NEW CURRENT' 

p(e) [-125,+20] t'POSITION)' 

; 'Return to start and draw inner arc with gap for text' 

p(e) [-10,-10] (b) [-2,-7] t(d-45,s0) 'V w(p4) 

p(e) c(a-28c) [384,140] w(e,pO) c (a-34c) [384 , 140] 

w(v,pl) p(b) [ + 10,-20] t(dO,sl) '-90' p(e,b)[,-5] t'degrees' p(e) 

w(p4) c(a-28c) [384,140] p[ + 5,-4] t (d-135 ,sO) 'V ' (dO , si ) 

; 'Add command' 

w(pl) p[300,350] t'c(a-90c) [-100,-100] ' 

FIGURE 5-8 

p[100,200] (b) c[+3] c(s) [] [370,50] [420,360] [120,390] [](e) 

^.(e) [-90,-10] t' [100,200]' p[-50,+20] t'START POSITION' 

p[370,50] c[+3] p[+7,-20] t' [370,50]' 

p[420,360] c[+3] p[+5,+5] t' [420,360]' 

p[120,390] (b) c[+3] p[-90,-10] t' [120,390]' p ( e) [-50 , -30] 

t'END POSITION' p[100,430] 

t'p[100,200] c(s)[] [370,50] [420,360] [120,390] [](e)' 
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FIGURE 5-9 

p[230,240] c[+5] c(b) [320,160] c[480,120] 

c[570,160] c [480,240] c[320,280] c{e) c[+10] 

p[230,240] (b) [-90,-10] f [230,240] ' 

p(e,b) [-90,+10] t'START' 

p(e) [-90,+30] f POSITION' 

p[320,160] c[+3] p[-80,-20] f [320,160]' 

p[480,120] (b) c[+3] p[,-30] f [480,120]' 

p(e)[,-50] t'END POSITION' 

p[570,150] c[+3] p[+5,-10] t' [570,160]' 

p[480,240] c[+3] p[+5,+5] t' [480,240]' 

p[320,280] c[+3] p[,+5] t' [320,280]' 

p[220,350] t(sl) 'p[230,240] c (b) [320 , 160] [480,120] 

[570,160] [480,240] [320,280] (e) ' 

FIGURE 5-11 

P [100,0] T[+3 6,+0] (S [3 2,60] ,M[4,6]) 'ABCD' 

P[100,85] T[+32,+28] 'ABCD' 

P[200,255] T[-32,+44] 'ABCD' 

P [100, 60] T(S1) "T[+36,+0] (S [32 , 60 ] ,M [4 , 6 ] ) 'ABCD' " 

P [100, 235] T(S1) "T[+32,+28] 'ABCD' " 

P[100,450] T(S1) "T[-32,+44] 'ABCD' " 

FIGURE 5-13 

P[100,0] T[ + 3 6,+0] {S[32,60],M[7,10]) 'ABCD' 
P [100, 120] T[+36,+0] (S[32,60],M[1,2]) 'ABCD' 
P [100, 240] T[+36,+0] (S [32 , 60] ,M [4 , 6] ) 'ABCD' 
P[100,70] T(S1) "T[+36,+0] (S[32,60] ,M[7,10]) 'ABCD' " 
P[100,190] T(S1) "T[+36,+0] (S[32,60] ,M[1,2]) 'ABCD' " 
P[100,310] T(S1) "T[+36,+0] (S[32,60] ,M[4,6]) 'ABCD'" 

FIGURE 5-15 

p[100,150] t(d45,s4) 'ABCD' 

p[100,200] t(dO,sl) 'p[100,100] t (d45, s4) ' ABCD' ' 

p[100,370] t(d45,s4,d0) 'ABCD' 

p[100,420] t(d0,sl) 'p[100,400] t (d45, s4 ,d0 ) ' ABCD' 

p[400,200] t(d-45,s4,d0) 'ABCD' 

p[400,400] t(dO,sl) 'p[400,200] t (d-45, s4,d0 ) ' ABCD' 
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FIGURES 5-17 to 5-20 

; "FRAME. PIC" 

p[50,50] c(a-90) [0,50] 

w(v)p[50,0]v[717] c(a-90c) [717,50] 

v[,430] c(a-90c) [717,430] 

p[720,479] v[50] p[50] c (a-90c) [50 , 429] 

v[,50] p[717,50] w(e)v[] p[25,25] 

w(v)v[742] [,454] [25] [,25] 

;"WRMODE.PIC" 

;set up box drawing macrograph 

@:av[ + 200] [, + 200] [-200] [,-200]@; 

; ' set up erase macrograph' 

@:ep[717,50]v(w{e,sl[,430]))[50]p[200,100]@; 

@e 

t(i0,s3)w(v,sl[,200]"/")@a 

p[200,100] 

p[+50,+50]w{sl"\")@a 

p[180,400]t(s2) 'OVERLAY WRITING' 

; ' the next command waits 2 seconds, then prints display' 

s(tl20,h(p[100,300] ) ,h)@e 

t(i0,s3)w(r,sl[,200]"/")@a 
p[200,100] 

p[+50,+50]w(sl"\") @a 
p[180,400]t(s2) 'REPLACE WRITING' 
s(tl20,h(p[100,300]) ,h)@e 

t(i0,s3)w(v,sl[,200])@a 
p[200,100] 

p[+50,+50]t(a0)w(c,sl"\")@a 
p[160,400] t(s2) 'COMPLEMENT WRITING' 
s{tl20,h(p[100,300]) ,h) @e 

t(i0,s3)w(v,sl[,200] "/")@a 
p[200,100] 

p[+50,+50]w(e,sl"\")@aw(v) 
p[200, 400] t(s2) 'ERASE WRITING' 
s{tl20,h(p[100,300] ) ,h) (e) 



FIGURE 5-25 

p[0,200] t(slO) '12345678' 

p[0,0] v[767] [,479] [0] [,0] 

p[100,100] v[484] [,340] [100] [,100] 

p[0,0] (b) [ + 5, +5] t(sl) ' [0,0] ' 

p(e) [+25, +25] 

v[95,95] p[-7,+2] t(d45sO)'V' 

p[ 100, 100] [ + 5, +5] t(dOsl) 'S [100, 100] 

p[767, 479] [-95,-25] f [757,511]' 
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ANSI GLOSSARY 



Active position The character position on the visual display 

that will display the next graphic character. 

ANSI mode A VT100 mode that recognizes and responds only 

to escape sequences whose syntax and semantics 
comply with ANSI specifications. The graphics 
processor always is in ANSI mode. 

Character position Part of the visual display that can display a 

graphic symbol. 

Control A control character, escape sequence, or 

control sequence that performs a control 
function. 

Control character A character that can initiate, modify, or 

stop a control function. 

Control function An action that affects the recording, 

processing, transmission, or interpretation of 
data. 

Control sequence A sequence of characters used to perform a 

control function that begins with the control 
sequence introducer (CSI) control and may 
contain a parameter string. 

Control sequence An escape sequence that provides supplementary 
introducer (CSI) controls and is itself a prefix affecting the 

interpretation of a limited number of 

contiguous characters. 

Control string A string of characters that performs a control 

function and is delimited by an opening and 
closing delimiter control. 

Cursor A blinking reverse-video or underline that 

represents the active position. 

Cursor control A function that moves the active position. 

Default A function-dependent value assumed when no 

value, or a value of 0, is specified. 
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Display 



Escape character 
(ESC) 



Escape sequence 

Final character 
Graphic character 

Graphic object 
HLS 

Home 



Intermediate 
character 



Macrograph 



Numeric parameter 
Parameter 

Parameter string 
Pixel 



The active area of the screen inside the 
scrolling region, or the entire screen, 
depending on the origin mode. 

A control character that provides 
supplementary characters (code extension) and 
is itself a prefix affecting the 
interpretation of a limited number of 
contiguous characters. 

A sequence of characters used to perform a 
control function the first character of which 
is the escape (ESC) control character. 

A character whose bit combination terminates 
an escape or control sequence designated by F. 

A character, other than a control character, 
that has a visual representation normally 
handwritten, printed, or displayed. 

A geometric shape that can be described with a 
few characters of information. 

Hue, Lightness, Saturation. A three parameter 
system for describing a color on a video 
monitor. 

The character position at the origin. [See 
origin mode (DECOM) ] . 

A character whose bit combination precedes a 
final character in an escape or control 
sequence. 

In ReGIS, any series of sequential commands 
that are stored in the terminal's memory and 
performed (invoked) on request by two 
characters. Macrographs reduce communication 
line traffic between the terminal and the 
computer when the same commands are used again 
and again. 

A string of bit combinations that represents a 
number, designated by Pn or Ps . 

(1) A string of one or more characters that 
represents a single value, (2) The value so 
represented. 

A string of characters that represent one or 
more parameter values. 

The smallest unit of information on a graphics 
display. 
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Protocol The conventions or rules for the format and 

timing of messages sent and received. Devices 
must be using the same protocol to understand 
each other. 

ReGIS Remote Graphics Instruction Set. A set of 

graphics object description commands. 

Selective parameter A string of bit combinations that selects a 

subfunction from a specified list of 
subfunctions, designated by Ps. In general, a 
control sequence with more than one selective 
parameter causes the same effect as several 
control sequences, each with one selective 
parameter. For example, CSI Psa; Psb; Psc F is 
identical to CSI Psa F CSI Psb F CSI Psc F. 

VT52 mode A VT100 mode which recognizes and responds 

only to escape sequences which DEC VT52 type 
terminals use. The graphics processor does not 
have VT52 mode. 
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OTHER TERMINALS 



GENERAL 

The terminal is a vital link between the user and the power of the 
computer. Often the right terminal, or the right enhancement to 
your terminal, can make your work easier, more efficient, or more 
cost effective. For that reason, DIGITAL offers a full range of 
video and printer terminals and options that can help you tackle 
any application. 

PRINTER TERMINALS 

DIGITAL'S printer terminals are noted for their strength and 
reliability, selectable baud rates, and multiple user-selectable 
features, that provide all the flexibility you need to efficiently 
configure your work stations. 

DECwriter III 

DIGITAL'S LA120 DECwriter III is the performance terminal for 
high-speed communications. At 180 characters per second the 
DECwriter III boosts throughput by combining bidirectional smart 
printing and a 100-character buffer with fast horizontal and 
vertical skipping over white space. The LA120 also offers the 
convenience and flexibility of more than 45 key-board-selectable 
features. These features include variable font sizes, tabs, form 
lengths, and many other time saving features previously available 
only as options. Mnemonic commands, prompting LED display, a 
special decal, and a convenient pocket-sized operator card all 
make the LA120 easy to set up and use. 

A selectable baud rate (up to 9600) along with automatic self-test 
diagnostics give you the performance and reliability 
characteristics you look for in a high-speed communications 
terminal . 

DECwriter IV 

DIGITAL continues to develop new technology and better terminals 
with functional specifications our customers demand. The new 
DECwriter IV is the latest in small convenient printers. It comes 
in two models, both ligth and compact enough to be easily 
transported to the most convenient work station for maximum 
efficiency. The LA34 is the desk-top model with designer 
appearance and typewriter-like keyboard. It is smaller, lighter, 
and quieter than many typewriters. The easy-to-change ribbon 
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cartridge, roll-free paper, and convenient keyboard-selectable 
features — like four character-width adjustments — make this 
terminal simple enough for anyone to use. 

The LA38 comes with tractor feed for multipart forms and includes 
roll feed for standard paper. A numeric keypad is standard for 
fast input of accounting data. 

The DECwriter IV terminals include standard features such as 
microprocessor control, true 30 characters per second throughput, 
up to 9600 baud rate, and DECwriter reliability. These features 
give you all the performance you need in a convenient size 
package . 

DECwriter IV Graphic Printer 

DECwriter IV Graphic Printers are receive-only (RO) 
micropricessor-controller , low-cost, desk-top printers. They use 
an impact dot matrix printing technique for character 
representation. DECwriter IV Graphic Printers operate in one of 
two printing modes, text or graphic. In text mode, characters are 
printed as they are received. In graphic mode, received characters 
define columns of printed dots. 

The printer can be used as an output device for a computer or word 
processor so that characters received from the computer are 
printed. The graphic printer can also be used as the output device 
for a graphic terminal such as the VT125 or the VK100. 

VIDEO TERMINALS 

DIGITAL'S video display terminals offer unmatched convenience and 
capabilities with features designed to give you performance you 
would expect from much more expensive and complex equipment. 

VIDEO TERMINAL 

For the ultimate in video terminals, look to DIGITAL'S VT100. It 
combines exceptional versatility with simplicity of operation. And 
it's designed to allow a wide range of fast and easy field 
upgrades to meet your changing needs. There is a detached 
typewriter-style keyboard with a flexible, 3-wire coiled cord. An 
18 key numeric/function keypad on the keyboard permits single 
keystroke control of application-specific functions. The VT100 
fits easily on a standard typewriter table. There is an advanced 
video option that provides 132-column lines of the screen for easy 
viewing of wide-line printer reports. Double height/double width 
characters are selectable line by line for easier reading and text 
formatting. Smooth scrolling a scan at a time lets your operators 
read new lines at a reasonable speed. Divided-screen displays; 
blinking, underlining, double intensity and normal or reverse 
video character attributes; keyboard and/or computer-settable tab 
stops; built-in, self-test diagnostics; pictorial capability; and 
many, many more. 
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EK-VT125-UG-CN1 



TECHNICAL DOCUMENTATION 
CHANGE NOTICE 



VT125 User Guide Additions and Corrections 
{EK-VT125-UG-001) 



Change step 9, Page 8-5, to read: 

9 Connect the communication cable to the appropriate connector at the back 
of the terminal. If using the EIA interface, install the EIA line filter connec- 
tor with a 5 mm (3/16 in) screwdriver (Figure 8-3). Then fasten the cable 
connector to the terminal tightening the captive screws with a 3 mm (1/8 in) 
blade screwdriver. Be sure to attach the cable ground wire to one of the cap- 
tive screws. (Refer to Chapter 5 for information about connector use and 
signal/pin definitions.) 



Replace the existing Figure 8-3 with this new one: 




digital equipment corporation • maynard, massachusetts 



Change the VT125 Upgrade Installation Procedure in Chapter 10: 

• Add one to the figure numbers from 10-1 1 to 10-16, making them 10-12 to 
10-17. 

• Change the old Figure 10-17 to Figure 10-11. 

• Change step 1 7 on Page 1 0-1 6 to read : 

1 7 . Install the VT 1 00 end of the 1 6-pin flat cable connector to the lower 1 6 pins 
of the terminal controller board's graphic connector (marked J 2 on the 
terminal controller board), with the cable entering from the right (Figure 
10-12). 

Change step 21 on page 10-21 to read: 

2 1 . Arrange the 1 6-pin graphic connector with the cable entering from above 
and install it into the connector at the top edge of the VT125 board (Figure 
10-15). 

Change step 29 on Page 1 0-2 1 to read : 

29. Perform the installation, power-up, and checkout procedure that is described 
in Chapter 8. If using the EIA interface, be sure to install the EIA line filter 
connector as shown in Figure 8-3. 



